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Preface 



Introduction 



Audience 



This document describes the software features of an Alpha microprocessor mother- 
board. The motherboard software is intended to provide software monitor and debug 
capabilities to customers who use an Alpha microprocessor motherboard as a develop- 
ment platform for creating their own Alpha microprocessor-based systems. 



This document is for anyone who develops software or hardware to be used with an 
Alpha microprocessor. The Alpha Microprocessors Motherboard Debug Monitor 
(Debug Monitor) supports the following products: 



Alpha 21264 Motherboard (AlphaPC 264DP) 
Alpha 21164 Motherboard (AlphaPC 164SX) 
Alpha 21164 Motherboard (AlphaPC 164LX) 



Content Overview 



The information in this document is organized as follows: 

Chapter 1 is an introduction to the Debug Monitor. 

Chapter 2 describes how to use this Debug Monitor. 

Chapter 3 describes how to use remote debugging. 

Chapter 4 lists all Debug Monitor commands. 

Appendix A contains information about customer support services and associated 
documentation. 
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Conventions 



In this document, the term motherboard refers to the AlphaPC 264DP Motherboard, 
the AlphaPC 164SX Motherboard, and the AlphaPC 164LX Motherboard, unless other- 
wise noted. 

The following conventions are used in this document: 



Convention 


Definition 


A percent sign (%) 


Indicates a Tru64 UNIX operating system command prompt. 


A pound sign (#) 


Indicates a Tru64 UNIX superuser prompt and indicates that 
these commands are performed from the root directory level. 


Square brackets ([]) 


Denote optional syntax. 


Boldface type 


Indicates Debug Monitor command text. 


DP264> 


Indicates the motherboard command prompt. 


Italic type 


Emphasizes important information, indicates variables in 
command syntax, and denotes complete titles of documents. 


Monospaced type 


Indicates an operating system command, a file name, or a 
directory path name. 



All numbers are decimal unless otherwise indicated. Where there is ambiguity, numbers 
other than decimal have a subscript indicating their base. 
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1 



Introduction 



1.1 Overview 



The Alpha Microprocessors Motherboard Debug Monitor can be used to load code into 
the system and perform other software debug functions, such as memory 
read/write and instruction breakpointing. You can develop your code on a host system 
and load the software into the motherboard through a serial port, Ethernet port, user- 
supplied floppy drive, or the extra ROM socket. The full source code is provided with a 
free license, allowing you to use and modify this code as you desire. 



1.2 General Features 

The Debug Monitor offers the ability to: 

• Download files via serial and Ethernet ports, ROM socket, and user-supplied 
floppy drive. 

• Examine and deposit the motherboard system register, CPU internal processor reg- 
isters (IPRs), and I/O mapped registers. 

• Examine and modify DRAM and I/O mapped memory. 

• Disassemble CPU instructions in memory. 

• Transfer control to programs loaded into memory. 

• Perform native debugging, including breakpoints and single stepping. 

• Perform full source-level debugging using the DIGITAL Ladebug debugger (Lade- 
bug) for Tru64 UNIX running on a remote host that communicates through an 
Ethernet connection. 

1.3 Recommended Host System 

The recommended host system for software development is an Alpha system running 
the Windows NT or Tru64 UNIX operating systems. Alpha hardware is the platform 
upon which the initial set of portable development tools is provided. The native Tru64 
UNIX and Windows NT software development tools are used in conjunction with the 
portable tools. 

The Tru64 UNIX operating system also supports the bootstrap protocol (BOOTP) for 
downloading executable images to the motherboard and Ladebug for remote debug- 
ging. The examples in this manual that pertain to a host system are based on Alpha 
hardware running the Tru64 UNIX operating system. 
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2 

Getting Started 



2.1 Overview 

This chapter describes how to set up your motherboard and host system. 

2.2 System Requirements 

The minimum configuration that you need in order to use your motherboard is a power 
supply and a terminal. However, to take full advantage of the motherboard, you need an 
Alpha host development system running the Windows NT or Tru64 UNIX operating 
systems. 

2.3 Configuring Your System 

This section describes how to connect your motherboard to the following: 

• A terminal 

• A PC running communication software 

• A system running Windows NT 

• An Alpha system running Tru64 UNIX 

You need to provide a power supply for the motherboard. See your motherboard's 
user's manual for more information about requirements for your power supply. 

2.3.1 Connecting to a Terminal 

To connect the motherboard to a terminal, connect the terminal communication line to 
serial port 1 of the motherboard. Your terminal should be set to match the baud rate of 
the motherboard. The most current and reliable source for this information is your 
motherboard's user manual. 

After the terminal and the motherboard are connected and the motherboard is powered 
on, the terminal screen should display the banner and prompt. For example: 

DECchip 21264 (DP264) Debug Monitor 
Version: Tue May 04 16:55:54 EDT 1999 
Bootadr: 0x100000, memSize: 0x2000000 {32MB) 

DP264> 
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Configuring Your System 



Note: Using a terminal in tiiis manner is tiie most effective way to quickly verify 

that your motherboard was not damaged during shipping. You can use the 
onboard ROM to load and boot software through a compatible ROM. How- 
ever, to download a file, you need a system running terminal emulation 
software that has the capability of performing text dumps through the serial 
connection or through an Ethernet connection to a host system that sup- 
ports the BOOTP protocol. 

2.3.2 Connecting to a PC 

Communication (terminal emulation) software running on a PC can also be used to 
communicate with the motherboard. To connect the motherboard to a PC, connect the 
terminal communication line to serial port 1 of the motherboard as described for the ter- 
minal. 

2.3.3 Connecting from a System Running Windows NT 

A system running the Windows NT operating system supports serial communication 
with the motherboard. To configure a COM port, follow these steps: 

1. Choose the Program Manager icon. 

2. Choose the Accessories icon. 

3. Choose the Terminal icon. 

4. Set the following terminal characteristics: 



Terminal Setting 


Value 


Data bits 


8 bit 


Transmit/receive speed 


9600 baud 


Character format 


No parity 


Stop bits 


1 



Save these settings in a file. For example, settings for the DP264 could be saved in a file 
called dp2 64 . trm. 

For consistency, all examples and command descriptions assume that the motherboard 
serial port 1 is connected to COMl. 

2.3.4 Connecting from a System Running Tru64 UNIX 

Tru64 UNIX supports serial communications and Ethernet communications with the 
motherboard. 

An Alpha system running the Tru64 UNIX operating system supports serial communi- 
cation through the following two ports that can be connected to the motherboard: 

• /dev/ttyOO 

• /dev/ttyOl 

For consistency, all examples and command descriptions assume that the motherboard 
serial port 1 is connected to port /dev/ttyOO. 
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Configuring Your System 



To enable these ports for use with the motherboard, follow these steps: 

1 . Log in as superuser. 

2. Modify the following two files: 

/etc/remote 
/etc/inittab 

a. Add the following two lines to the /etc/ remote file. These lines define a 
device to connect to when using the Tru64 UNIX tip command. 

port_nameO: dv=/ciev/ttYOO :br#9600:pa=none: 
port_namel : civ=/ciev/ttY01 :br#9600:pa=none: 

The port_name refers to an arbitrary name that you assign to that port. 

b. Modify the /etc/inittab file to disable logins on the two serial 
communication ports by setting the third field to of f . For example, modify the 

ttyOO andttyOl lines as follows: 

ttY00:23:off :/usr/sbin/gettY /dev/ttYOO 9600 
ttY01:23:off :/usr/sbin/gettY /dev/ttYOl 9600 

3. Reboot the system or issue the following command to ensure that the modified files 
take effect: 

# /sbin/init q 

2.3.4.1 Connecting to a Serial Port 

After you modify the /etc/remote and /etc/inittab files, you can connect to 
the serial port under the Tru64 UNIX operating system using the Tru64 UNIX tip 
command. If the connection is successful, the motherboard prompt displays, and you 
are ready to use the Debug Monitor load or boot commands to download your file. For 
example: 

% tip port_nameO 
DP2 64> load 

Send File now . . . 

Type ~> to cause the Tru64 UNIX t ip command to send the file to the motherboard. 

2.3.4.2 Setting Up the Host System as a BOOTP Server 

The bootstrap protocol (BOOTP) needs to be defined so that the commands netload 
and netboot work correctly. To set up a Tru64 UNIX system as a BOOTP server, follow 
these steps: 

1. Modify the /etc/inetd. conf file. This file enables both the BOOTP and the 
TFTP daemons. The TFTP daemon is required by the BOOTP daemon. 

a. Add the following line to specify the directories that can be accessed by the 
TFTP daemon: 

tftp dgram udp wait root /usr/sbin/tftpd tftpd /directory l/directory2 

If no directory is specified, all files with public access can be accessed by the 
TFTP daemon. 

b. To start the BOOTP daemon, enter the following line: 

bootps dgram udp wait root /usr/sbin/bootpd bootpd -d -d -d 
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2. If BOOTP is already running on your system, you want to stop it. To stop BOOTP, 
enter tiie following commands: 

# ps uax I grep bootpd 

# kill -KILL process_id_number 

# ps uax I grep inetd 

# kill -HUP process_id_number 

3. To restart BOOTP, enter the following command: 

# /sbin/init q 

The changes made to the /etc/inetd.conf file will now take effect. 

4. Modify the /etc/bootptab file to specify the Ethernet hardware address of the 
motherboard and the IP address assigned to that node. Contact your network 
administrator to obtain an IP address. Refer to the literature supplied with your 
Ethernet card to obtain information about the hardware address. If the hardware 
address is accessible through software, you can use the einit command to display it. 
For example, the following lines modify this file for the DP264: 

remote_system_nameO :ht=ethernet :ha=BA9876543210 : ip=16 . 123 . 45 . 67 : \ 
: hd=/dlrectoryl •.hf= filename •.vm=auto : 

BOOTP checks this file to see if it has changed each time it receives a request. If it 
has changed, the new file is read. The directory anA filename are the defaults for the 
netload and netboot commands. If no argument is specified with either command, 
the file loaded is /directoryl/f ilename. 

Verify the BOOTP Server 

To verify that the BOOTP server has been set up properly, you can look at the dae- 
mon . log file. This file shows directories accessed for the netload or netboot com- 
mands. 

# tail -f /var/adm/sylog. dated/datecLdir/daemon . log 

The following example displays a boot request from an example daemon log file: 

May 5 10:40:28 eval bootpd[328] :request from hardware address 
BA9876543210 

May 5 10:40:28 eval bootpd[328] :found: dp264 (BA9876543210) at 
(16.123.45.67) 

May 5 10:40:28 eval bootpd[328] :f ile /users/eval/boot/size .dp264 
not found 

May 5 10:40:28 eval bootpd[328] :vendor magic field is 0.0.0.0 

May 5 10:40:28 eval bootpd[328] :sending RFC1048-style reply 

You can refer to the Tru64 UNIX man pages for more information about bootp, 
bootpd, tftp, tftpd, inet, inetd, and init. 
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Installing the Debug Monitor Firmware 

2.3.4.3 Setting Up the Host System as a Ladebug Client 

The Debug Monitor supports remote debugging for Tru64 UNIX host systems with 
Ladebug. The Ladebug software does not accept numeric Internet addresses. You can 
give your motherboard an internet name in the /etc/hosts file. In the 
/etc/ ho St s file, the format is the Internet protocol (IP) address followed by the host 
system name. For example: 

12.345.67.89 remote_system_nameO 

2.4 Installing the Debug Monitor Firmware 

This section explains how to program the Debug Monitor firmware into a flash ROM 
on the motherboard by using the fail-safe hooter. For more details about the fail-safe 
hooter, see the user's manual for your motherboard. 

1 . Put the Debug Monitor firmware on a floppy diskette. 

2. Set the switch on the motherboard to the position which loads the fail-safe hooter. 
See your motherboard's user manual for this information. 

3. Insert the floppy diskette into your system. 

4. Reset the system. 

5. Load the file from the floppy diskette into main memory by using the flload com- 
mand: 

DP2 6 4>flload cip264dbm. rom 

6. The DP264> prompt displays. Enter the flash command: 

DP264>flash 

Image source address: 0x300000 

Searching for Standard ROM image header: Found. 
Header Size 0x38 (56) bytes 



Image Checksum. . . 
Memory Image Size 
Compression Type 
Image Destination 
Header Version. . . 

Firmware ID 

ROM Image Size . . . 



0xff4b (65355) 

. 0x31300 (201472 = 196 KB) 

. 
0x0000000000300000 

2 

- Alpha Evaluation Board Debug Monitor 

0x31300 (201472 = 196 KB) 
Firmware ID (Opt.) .. 03010098102 91137 

ROM offset 0x00000000 

Header Checksum 0x7acl 

Enter destination offset or press RETURN for default [0] : (Return) 

Flash offset : 0x0 

Image size w/ header: 201528 (Block to 3 inclusive) . 
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! ! ! ! ! Warning! About to overwrite flash memory ! ! ! ! ! 
Press Y to proceed, any other key to abort. 
Y 
Writing Flash Block: OV IV 2V 3V . . . 

7. The Debug Monitor is now in flash memory. 
To restore the firmware: 

1. Use the flasherase command to erase the Debug Monitor from flash memory: 
flasherase 3ffff 

2. Run the normal update procedure described in your motherboard's user's manual by 
using the firmware update diskette supplied with your motherboard or downloading 
firmware from the Alpha OEM website described in Appendix A . 

2.5 Debug Monitor Memory Map 

The Debug Monitor image is loaded from the system ROM into memory at physical 
address by the SROM initialization code. At startup, the Debug Monitor determines 
the amount of memory present in the motherboard based on parameters that are passed 
in from the SROM initialization code. One of these parameters determines the top of 
main memory. Refer to your motherboard's user's manual for more information about 
the SROM initialization code and supported memory configurations. 

Figure 2-1 shows the basic outline for the Debug Monitor memory map. 



Figure 2-1 Debug Monitor Memory Map 



0x300000 



0x200000 



0x100000 



0x10000 
0x0 



8KB Guard Page 



Stack 






DMA Buffers 



Debug Monitor Kernel 



Debug Monitor PALcode 



Top of Main Memory 
Top of Stack 



Default Boot Address 
(bootadr) 



DMA Buffer Base 

Debug Monitor Entry 
PALcode Base Address 

FM-05670.AI4 
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2.5.1 Stack 



Downloading Files 



The Debug Monitor image consists of PALcode at physical address and the Debug 
Monitor kernel at physical address IOOOO15. After loading the image into memory, the 
SROM initialization code begins execution of the image in PALmode at the PALcode 
base address. 

The PALcode used in the Debug Monitor was designed to support Tru64 UNIX and 
was later adapted to the Debug Monitor. Refer to the Alpha Architecture Reference 
Manual and the PALcode for Alpha Microprocessors System Design Guide for more 
information about Tru64 UNIX PALcode. 



PALcode starts execution of the Debug Monitor kernel at physical address lOOOOjg. 
Upon entry to the Debug Monitor kernel, the Debug Monitor establishes the initial 
stack pointer at the first 8KB boundary below the top of main memory. From there the 
stack grows downward. 



2.5.2 DMA Buffers 



Various devices used with the motherboard require direct memory access (DMA). The 
device drivers provided in the Debug Monitor for these devices are designed to perform 
their DMA within a 1MB range starting at 1 megabyte (physical address 1 00000 jg). At 
startup, the Debug Monitor initializes the I/O subsystem with DMA windows that 
include this range. The device drivers included with the Debug Monitor that require 
DMA are the Ethernet and diskette drivers. Although the ebuff command can be used 
to change the base of the Ethernet buffers, the buffers must remain within this 1MB 
window. 



2.6 Downloading Files 



The motherboard supports loading files into memory from a serial port, the Ethernet, 
and a diskette. The user can either load the file into memory, or load and execute the file 
in a single step. The following table shows the commands for the specific I/O devices. 
See Chapter 4 for more details about these commands. 



I/O Device 


Use this command to 
load into memory... 


Use this command to 

load into memory and execute... 


ROM socket 


romload 


romboot 


Serial port 


load 


boot 


Ethernet 


netload 


netboot 


Diskette 


flload 


flboot 



The default boot address (bootadr) is 300000 jg. However, you can change the default 
boot address with the bootadr command. The new setting is then stored in the battery - 
backed RAM. 
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2.7 Execution Commands 

After your program is loaded, you are ready to execute it. If the command loads and 
executes a program, you may want to re-execute the program during the motherboard 
session. The Debug Monitor has two commands to execute programs: go and jtopal. 
See Chapter 4 for more details about these commands. 

2.8 Resetting the Debug Monitor 

If the software hangs the motherboard, then the hardware reset on the board can be used 
to reset to the Debug Monitor command line. For information about connecting the 
reset signals, see your motherboard's user's manual. 
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The Debug Monitor supports remote debugging for Tru64 UNIX host systems with 
Ladebug. The Ladebug software provides the full source-level debugging capabilities 
of most programs that run on the motherboard, including the Debug Monitor. 

This chapter describes some debugging hints to use with the Debug Monitor and the 
remote debugger. This chapter also describes the guidelines for writing programs that 
allow you to take full advantage of remote debugging. 

3.1 What Is a Debugger? 

A debugger is a tool that helps you locate run-time programming errors or bugs. You 
use the debugger on executable programs created when a program has been compiled 
and linked successfully. 

3.2 What Is a Remote Debugger? 

A remote debugger is a tool that helps you locate run-time programming errors or bugs 
in a program running on a remote system. The remote system can be a system that can- 
not support a full programming environment by itself. You use a remote debugger on 
executable programs compiled and linked for the remote system. 

3.3 Remote Debug Server 

The Debug Monitor's remote debug server (the part of the monitor that communicates 
with Ladebug) uses interrupts and an Ethernet device. Interrupts are used by the Debug 
Monitor to poll the Ethernet device for messages from Ladebug. Any program that 
changes the interrupt handler must instruct the debug server when to poll the Ethernet. 

3.4 Programming Guidelines 

The following sections describe the programming guidelines for remote debugging. 

3.4.1 The Run-Time Environment 

When a program is started by the Debug Monitor's go command, it is started at the 
appropriate IPL to enable real-time clock interrupts (usually IPL 4). If a program does 
not install its own interrupt handler, then the Debug Monitor will handle all interrupts. 
If a program does install its own interrupt handler using the Write System Entry 
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Address PAL call, then it must be prepared to handle all interrupts as described in the 
following sections. When a program completes normally, the Debug Monitor reinstalls 
its own interrupt handler. 

3.4.2 Types of Programs 

For the purposes of this chapter, programs may be classified into the following three 
types: 

• Programs that do not use the Ethernet or do not include their own interrupt handler 

• Programs that do not use the Ethernet but do include their own interrupt handler 

• Programs that use the Ethernet 
3.4.2.1 Restriction 

There is only one restriction for programs that do not use the Ethernet and that use the 
Debug Monitor interrupt handler. Do not disable the real-time clock interrupt and the 
Ethernet interrupts for long periods. 

Long delays may cause Ladebug to behave as if there is a problem with the Ethernet 
link to the target. If network delays are insignificant, Ladebug will tolerate periods of 
up to 10 seconds with interrupts disabled, although it will normally warn the user of 
possible network problems if interrupts are disabled for more than a second. Ethernet 
interrupts are disabled at IPL 3 or more, and real-time clock interrupts are disabled at 
IPL 5 or more. Writing to the control registers of the Ethernet device or to the real-time 
clock can also disable the interrupts. It is possible to set breakpoints or to single step 
uninterruptible code. There is no restriction on the time that can be spent at the 
breakpoint. 

Programs that define or install their own interrupt handler must ensure that the Debug 
Monitor polls the Ethernet device often enough to receive all the messages sent to it by 
Ladebug. An easy way to do this is to use the ladbx_poll function. When this func- 
tion is called, the following occurs: 

• All frames that have been received on the Ethernet device are read. 

• All remote debug frames are processed and acted upon. 

• Any Ethernet interrupt is cleared. 

The ladbx_poll function is a void function that takes no arguments. It must be 
called often enough to allow the Debug Monitor to respond promptly to all received 
Ethernet frames. To ensure that this function gets called at the proper time, enable either 
Ethernet or timer interrupts (or both) and call it every time an interrupt occurs. 

Programs cannot share an Ethernet device with the Debug Monitor. The Debug Monitor 
can drive a selection of different types of Ethernet devices on ISA or PCI cards, and an 
individual Ethernet device can be selected with the Debug Monitor edevice command. 
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3.4.3 PALcode Environment 



Most programs will be able to use the Tru64 UNIX compatible PALcode included with 
the Debug Monitor; however, for the programs that install their own PALcode, the fol- 
lowing guidelines must be followed: 

• For remote debug to work, the following Tru64 UNIX PALcode calls must be 
implemented according to the interface described in the UNIX section of the Alpha 
Architecture Reference Manual. 

1MB 

RDUSP 

RTI 

WPIPL 

WRENT 

• The interface to the system must conform to the standards described in the 
UNIX section of the Alpha Architecture Reference Manual. 

• The debug server uses the DBGSTOP PAL call to implement breakpoints. The pro- 
gram must contain an identical implementation of the DBGSTOP PAL call. 

This PAL call, rather than the BPT PAL call, is used because complex programs 
(such as operating systems) are likely to reset the EntIF system entry point during 
initialization. 

• The program reset PALcode routine must preserve the address of the debug entry 
point through the installation of the new PALcode. For the motherboard PALcode, 
this address is held in the PAL temporary register with symbolic name ptEntDbg. 
The user-defined PALcode must also either preserve the address of the interrupt 
entry point (ptEntInt) or set the IPL to a level that prevents all interrupts until the 
program sets up its own interrupt handler containing a call to ladbx_poll. 

3.5 Ladebug Command Line Options 

Versions L3 or later of Ladebug provide the command line options shown in Table 3-1 to 
support remote debugging. 

Table 3-1 Ladebug Command Line Options 



Command Line Option 


Description 


-rn node_name 


Specifies IP node name of the target node. Required for 
remote debug. No default. 


-pid processjd 


Specifies the process id of the process to be debugged. The 
Ladebug software debugs a running process rather than 
loading a new process. 


-rfn arbitrary string 


Specifies the file name (or other identifier) of the image to 
be loaded on a remote system. Defaults to the local object 
file name. Passed to the remote system uninterrupted. Will 
often have to be quoted to avoid shell command line 
interpretation on the local system. Can be used only with 
-m; do not combine with -pid. 
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Table 3-1 Ladebug Command Line Options (Continued) 



Command Line Option 


Description 


-rinsist 


Connects to a running remote process using the connect 
insist protocol message instead of the connect protocol 
message. This option functions as a request to the server to 
connect to the client even if some other client is already 
connected. (The previously connected client is 
disconnected.) Use only with -rn and -pid. 


-rp debug protocol name 


Specifies the remote debug protocol to be used. The valid 
value and default is ladebug_preemptive. 


-rt transport protocol name 


Specifies the transport protocol to be used for remote debug. 
The valid value and default is UDP. 



Note: The debug server can be used only to debug already loaded processes; 

therefore, the pid option must always be specified. Because the Debug 
Monitor is not a multiprocessing system, the process id specified with this 
option is ignored. 

Because using the Debug Monitor with Ladebug is a subset of general Ladebug usage, 
the only meaningful command line has the following format, using both the -rn option 
and the -pid option: 

%laclebug size. out -rn cip254 -pid 

This example connects to the server on the node with IP node name dp2 64 and asks to 
debug the process with pid 0. The local object file is called size . out. Depending 
upon your network environment, you may need to fully specify the IP node name, such 

as dp 2 6 4 . my site. hlo. dec. c om. 

3.6 Building the Executable File 

To build the executable file for remote debugging, follow these steps: 

1 . Compile your source files using the -g option. This preserves the symbolic 
information in the source files. 

2. Link the source files with the -N and -Tx options; where x is the load address for the 
executable on the motherboard. 

3. Use the CSTRIP utility to strip the coff header from the executable file. Keep the 
unstripped executable file. 

3.7 Starting a Ladebug Session 

The Debug Monitor ladebug command configures the motherboard as a remote 
debugger target. Communication is performed through the Ethernet connection. 

To debug a program running on a motherboard using Ladebug running on a remote 
host, follow these steps: 

1. Set up the host Tru64 UNIX machine as described in Chapter 2. 

2. Start the motherboard. 

3. Load the program into memory on the motherboard. 
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4. Set a breakpoint in the program. 

5. Execute the program. The program will stop at the breakpoint and print the instruc- 
tion line at that location. 

6. Issue the ladebug command. This causes the motherboard to wait for a connection 
from Ladebug. 

7. From the host system, enter the command to start Ladebug and cause it to connect 
to the motherboard. 

The following example shows how to set up a sample session: 

DP2 64> netload size 

Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 

Init Block Address 100000 

Init Done. 

Ethernet BA-98-7 6-54-32-01 

Attempting BOOTP ... success . 

my IP address: 16.123.45.67 
server IP address: 16.123.45.69 
gateway IP address: 16.123.45.69 
Loading from /users/eval/boot /size ... 
#### 

DP264> stop 200000 
DP264> go 
Executing at 0x200000... 

00200000: 23DEFFF0 Ida sp, -16 (sp) 
DP2 64> ladebug 

Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 

Init Block Address 100000 

Init Done. 

Client connected : client is FFFFFFFFA0107F10 

The following command, entered from the host system, starts Ladebug and causes it to 
connect to the DP264: 

% ladebug size. out -rn dp264 -pid 

Welcome to the Ladebug Debugger Version 1.3.1 



object file name: size. out 

machine name: dp2 64 

process id: 

Reading symbolic information ...done 

Connected to remote debugger 

(ladebug) 

The (ladebug) in the previous example is the Ladebug prompt. You are now ready 
to debug a process that is running on the DP264. To end this session and return to the 
Debug Monitor command prompt, use the Ladebug quit command to disconnect from 
the server. 

Refer to the Ladebug documentation for more information about how to run Ladebug. 



8April1999 Remote Debugging 3-5 



4 



User Commands 



4.1 Overview 



This chapter describes how to use the Alpha Microprocessors Motherboard Debug 
Monitor commands. 

The Debug Monitor supports advanced command line editing, including cursor key 
movements and an Emacs-Iike editing interface. In addition, a history buffer has been 
added to facilitate repetition of commands. 

Table 4-1 shows the command line editing keypad. 
Table 4-1 Command Line Editing Keypad 



Keys 


Description 


. (period) 


Repeats the last command entered. 


t(up arrow) 
Ctrl/pl 


Scrolls up (older entries) the history buffer. 


i (down arrow) 

Ctrl/N 


Scrolls down (newer entries) the history buffer. 


<— (left arrow) 
Ctrl/B 


Moves the cursor one character to the left. 


-^ (right arrow) 
Ctrl/F 


Moves the cursor one character to the right. 


Backspace 

Delete 

Ctrl/H 


Deletes the character preceding the cursor. 


Ctri/D 


Deletes character at cursor position. 


Ctrl/K 


Deletes text from cursor to end of line. 


Ctri/R 


Refreshes the current line. 


Ctri/U 


Erases the current line of command text. 


End^ 
Ctrl/E 


Moves to the end of the line. 


Esc/B 


Moves the cursor to the previous word. 


Esc/Backspace 
Esc/DELETE 


Deletes the previous word. 


Esc/D 


Deletes the next word. 
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Table 4-1 Command Line Editing Keypad (Continued) 



Keys 


Description 


Esc/F 


Moves the cursor to the next word. 


Home 

Ctrl/A^ 


Moves to the beginning of the line. 


Insert 


Toggles between insert and overwrite mode. 


Return 

Ctrl/J 

Ctrl/M 


Enters the current command. 



If you connected to the motherboard through the Tru64 UNIX tip command, you must press 
Ctrl/P twice to obtain the normal effect of Ctrl/P. 

This key requires that the keyboard be connected directly to the motherboard. 



4.2 Using the Commands 



This section describes the Debug Monitor command categories. 

• Download and execution commands 

The motherboard software basic load command expects to receive Motorola 
S-records that are stored in the appropriate memory location. The Ethernet port 
provides improved download performance by using the Internet BOOTP protocol 
(a UDP-based protocol). This feature allows the motherboard system to determine 
its Internet address, the address of a boot server, and the name of a file to boot. The 
Debug Monitor also supports loading files from a floppy drive or the secondary 
ROM socket. 

The execution commands can be used to transfer control to a program in memory. 
These commands begin executing a program in memory at the specified address, or 
automatically with a download command. 

• Examine and modify memory commands 

These commands are used to examine and change memory in various formats 
beginning at a specified address and ending at a specified address. Quadwords (64 
bits), longwords (32 bits), halfwords (16 bits), and bytes (8 bits) are all supported 
by these commands. 

• PCI commands 

These commands are used to access PCI configuration space. 

• Utility commands 

These commands are used to display and modify the date and time, display the ver- 
sion of the Debug Monitor, and obtain information about commands implemented 
in the current version. 

• Debug commands 

These commands are used to debug software. Debug commands display internal 
CPU registers and provide debug capabilities, including breakpoints and single 
stepping. 
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Miscellaneous commands 



These commands are used to read and write the system register, perform an 
interrupt acknowledge cycle, call a subroutine, and connect to serial 
communication ports. 

• Ethernet commands 

These commands are used to set up and verify the status of the Ethernet port. 

• Diagnostic commands 

These commands are used to verify that the motherboard is working properly. 

4.3 User Commands Quick Reference 

Table 4-2 contains a summary of all Debug Monitor commands. The commands are 
grouped by category and function. 

Table 4-2 Command Summary Table 



Command 


Parameters 


Description 


Download and Execution Commands 


load 


address 


Downloads a file through the active serial port using the XMODEM 
protocol. 


boot 


address 


Downloads a file through the active serial port using the XMODEM 
protocol and begins execution. 


netload 


file, address 


Downloads the specified file through the Ethernet port at the current 
boot address or specified address. 


netboot 


file, address 


Downloads the specified file through the Ethernet port and begins exe- 
cution. 


fled 


drive_pathname 


Changes the current working directory to the specified drive or path. 


flcopy 


source_file, 
destination_file 


Copies the specified file to another location. 


fldir 


drive_pathname 


Displays a list of files in the current or specified directory. 


flload 


file, address 


Downloads the specified diskette file. 


flboot 


file, address 


Downloads the specified diskette file and begins execution. 


flread 


first_sector, bytes, 
dest_address, itera- 
tions, drive 


Reads logical sectors from a diskette. 


fl write 


first_sector, 
image_size, 
source_address, itera- 
tions, drive 


Writes data by logical sectors to a diskette. 


flsave 


file_name, 

start_address, 

file_size 


Saves the specified memory range to the specified file. 


romload 


type, address 


Loads the specified image from ROM to the specified address. 


romboot 


type, address 


Loads the specified image from ROM and begins execution. 
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Table 4-2 Command Summary Table (Continued) 



Command 


Parameters 


Description 


romlist 


none 


Lists the ROM image headers contained in ROM. 


romverify 


type, address 


Compares an image in memory to an image in ROM. 


bootadr 


address 


Sets default boot address. 


bootopt 


type 


Selects the operating system and firmware type to be used on the next 
power-up. 


go 


start_address 


Starts execution at the specified address. 


jtopal 


start_address 


Starts execution at the specified address in PALmode. 


init 


none 


Reinitializes the Debug Monitor 


Examine and Modify iUlemory Commands 


emb 


address, iterations, 
silent 


Examines and displays a byte of data in memory. 


eml 


address, iterations, 
silent 


Displays longword of data at the specified memory address. 


emq 


address, iterations, 
silent 


Displays quadword of data at the specified memory address. 


emw 


address, iterations, 
silent 


Examines and displays a word of data in memory. 


ddmq 


address, data, itera- 
tions 


Deposits the specified quadword of data in the specified memory 
address. 


dmb 


address, data, itera- 
tions 


Deposits the specified byte of data in the specified memory address. 


dml 


address, data, itera- 
tions 


Deposits the specified longword of data in the specified memory 
address. 


dmq 


address, data, itera- 
tions 


Deposits the specified quadword of data in the specified memory 
address. 


dmw 


address, data, itera- 
tions 


Deposits the specified word of data in the specified memory address. 


mt 


none 


Measures memory bandwidth. 


pq 


start_address, 
end_address, itera- 
tions, silent 


Prints memory in quadword (64-bit) format. 


pl 


start_address, 
end_address, itera- 
tions, silent 


Prints memory in longword (32-bit) format. 


pw 


start_address, 
end_address, itera- 
tions, silent 


Prints memory in word (16-bit) format. 


pb 


start_address, 
end_address, itera- 
tions, silent 


Prints memory in byte (8-bit) format. 


cq 


address 


Edits memory quadwords (64-bit). 
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Table 4-2 Command Summary Table (Continued) 



Command 


Parameters 


Description 


cl 


address 


Edits memory longwords (32-bit). 


cw 


address 


Edits memory words (16-bit). 


cb 


address 


Edits memory bytes (8-bit). 


fill 


start_address, 

end_address, 

fill_value 


Fills the specified memory block with the specified 32-bit pattern. 


copy 


start_address, 
end_address, destina- 
tion 


Copies a memory range to the specified address. 


compare 


start_address, 

end_address, 

compare_address 


Compares a memory range to a specified address. 


dis 


start_address, 
end_address 


Displays memory as CPU instructions. 


sum 


start_address, 
end_address 


Prints a checksum of a memory range. 


rl 


register, iterations, 
silent 


Reads a longword from a register port in I/O address space. 


rw 


register, iterations, 
silent 


Reads a word from a register port in I/O address space. 


rb 


register, iterations, 
silent 


Reads a byte from a register port in I/O address space. 


wl 


register, data, itera- 
tions 


Writes a longword to a register port in I/O address space. 


WW 


register, data, itera- 
tions 


Writes a word to a register port in I/O address space. 


wb 


register, data, itera- 
tions 


Writes a byte to a register port in I/O address space. 


mrl 


address, iterations, 
silent 


Reads a longword from memory in I/O address space. 


mrw 


address, iterations, 
silent 


Reads a word from memory in I/O address space. 


mrb 


address, iterations, 
silent 


Reads a byte from memory in I/O address space. 


mwl 


address, data, itera- 
tions 


Writes a longword to memory in I/O address space. 


mww 


address, data, itera- 
tions 


Writes a word to memory in I/O address space. 


mwb 


address, data, itera- 
tions 


Writes a byte to memory in I/O address space. 
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Table 4-2 Command Summary Table (Continued) 



Command 


Parameters 


Description 


sq 


start_address, 
end_address, string, 
inverse 


Searches the specified memory range by quadwords for the specified 
pattern. 


si 


start_address, 
end_address, string, 
inverse 


Searches the specified memory range by longwords for the specified 
pattern. 


sw 


start_address, 
end_address, string, 
inverse 


Searches the specified memory range by words for the specified pat- 
tern. 


sb 


start_address, 
end_address, string, 
inverse 


Searches the specified memory range by bytes for the specified pat- 
tern. 


PCI Commands 


pcishow 


id, bus, function 


Displays the contents of each PCI slot and current PCI to system 
address space mapping. 


prl 


pci_address, id, bus, 
function 


Reads a longword from the specified address in PCI configuration 
space. 


prw 


pci_address, id, bus, 
function 


Reads a word from the specified address in PCI configuration space. 


prb 


pci_address, id, bus, 
function 


Reads a byte from the specified address in PCI configuration space. 


pwl 


pci_address, id, data, 
bus, function 


Writes a longword to a specified address in PCI configuration space. 


pww 


pci_address, id, data, 
bus, function 


Writes a word to a specified address in PCI configuration space. 


pwb 


pci_address, id, data, 
bus, function 


Writes a byte to a specified address in PCI configuration space. 


Utility Commands 


date 


yymmddhhmmss 


Modifies or displays the date and time. 


flash 


source_address, 

destination_offset, 

bytes_to_write 


Programs data into flash memory. 


flasherase 


starting_offset, 
bytes_to_erase 


Erases data from flash memory. 


fwupdate 


none 


Loads and runs the firmware update utility. 


help 


command_name 


Displays a list of commands or displays parameter fields and syntax if 
a command is specified. 


apropos 


keyword 


Displays help text containing the specified keyword. 


ident 


start_address, 
end_address 


Displays RCS ID strings found in the specified memory range. 


sysshow 


none 


Displays SROM parameters. 


version 


none 


Displays the Debug Monitor firmware version information. 
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Table 4-2 Command Summary Table (Continued) 


Command 


Parameters 


Description 


swpipl 


ipl 


Sets or displays the current interrupt priority level (IPL) of the CPU. 


races 


mces_data 


Sets or displays the machine check error summary register. 


wrfen 


value 


Enables/disables floating point. 


Debug Commands 


preg 


address 


Displays CPU general-purpose registers. 


pfreg 


address 


Displays CPU floating-point registers. 


creg 


register_number, 
value 


Modifies CPU general-purpose registers. 


cfreg 


register_number, 
value 


Modifies CPU floating-point registers. 


stop 


address 


Sets a breakpoint at the specified address. 


bpstat 


none 


Displays the current breakpoint status. 


step 


none 


Executes a machine instruction by stepping into the first instruction of 
the function being called. 


next 


none 


Executes a machine instruction without stepping into subroutines. 


cont 


none 


Continues execution from a breakpoint. 


delete 


address 


Removes breakpoint from the specified address. 


ladebug 


none 


Starts a Ladebug server for a remote debug session. 


Miscellaneous Commands 


cominit 


none 


Initializes communications ports. 


lack 


none 


Performs an interrupt acknowledge cycle. 


rmode 


mode 


Sets the dis command register display mode. 


setty 


port 


Specifies the port used for Debug Monitor interaction. 


setbaud 


port, baud_rate 


Sets the communication port baud rate. The default is 9600. 


tip 


port 


Connects to a specified serial communication port. 


vinit 


none 


Initializes the video controller. 


Ethernet Commands 


edevice 


device_number 


Selects a registered Ethernet device. 


eshow 


none 


Displays all registered Ethernet devices. 


ereg 


none 


Displays the Ethernet controller registers. 


estat 


none 


Displays Ethernet statistics. 


einit 


none 


Initializes Ethernet controller and displays the Ethernet hardware 
address. 


estop 


none 


Stops the Ethernet controller. 


ebuff 


address 


Sets the base address for Ethernet DMA buffers. 
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Table 4-2 Command Summary Table (Continued) 



Command 


Parameters 


Description 


edmp 


status 


Sets or clears display of packets received or transmitted. 


eprom 


status 


Sets or clears flag for receiving all packets (promiscuous mode). 


arpshow 


none 


Displays all known address resolution protocol (ARP) entries. 


Diagnostic Commands 


beep 


duration, frequency 


Causes speaker to beep for the specified duration and frequency. 


mcheck 


state 


Controls the reporting of hardware error conditions (machine checks). 


memtest 


iterations, 
start_address, 
end_address, incre- 
ment, mcheck, 
stop_drivers 


Tests memory range. Uses longword accesses to memory. 



4.4 User Commands 



This section contains complete descriptions and examples of the Debug Monitor com- 
mands. The commands are listed in alphabetical order. 
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4.4.1 apropos — Display Help Descriptions 

The apropos command displays help descriptions for the specified keyword. 

Format 

apropos keyword 
Parameters 

keyword 

Specifies the string to match in the help command text. 

Description 



Example 



The apropos command is an additional form of help. This command searches the help 
file and displays all matches for the specified keyword. 



DP2 64> apropos load 

load: 

Downloads S records through a serial port 
syntax: load 
arguments : 

boot : 

Downloads S records through a serial port and begins execution 
syntax: boot 
arguments : 

netload: 

Downloads file via the Ethernet port to address. Address defaults 

to bootadr 

syntax: netload file address 

arguments : <opt str> <opt hex> 

netboot : 

Downloads file through the Ethernet port and begins execution 
syntax: netboot file address 
arguments: <opt str> <opt hex> 

Hit any key to continue. Control-C to quit... 
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4.4.2 arpshow — Display Known Address Resolution Protocol Entries 

The arpshow command displays all known address resolution protocol (ARP) entries. 



Format 

Parameters 

Description 



Example 



arpshow 



None. 



The arpshow command displays an IP routing table entry. If there are no ARP entries, 
nothing is shown for that device. The Ethernet device number displayed matches the 
number that is displayed when the eshow and edevice commands are entered. 

DP2 64> arpshow 

Arp Table Contents (at 0x00074570) : 

Ethernet Device 

IP Address: 16.123.45.67 

MAC Address: BA-98-76-54-32-10 
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4.4.3 beep — Test Speaker 

The beep command tests the speaker. 

Format 

beep duration frequency 
Parameters 

duration 

Specifies the duration of the beep in milliseconds. 

frequency 

Specifies the frequency in hertz. 

Description 

The beep command causes the speaker to beep for the specified duration and frequency. 
Example 

DP264> beep 1000 4000 
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4.4.4 boot — Download File Using XMODEM Protocol 

The boot command downloads a file through the active serial port using the XMODEM 
protocol and begins execution. 



Format 
Parameters 

Description 



boot [address] 

address 

Specifies the address at which to download the file. The default is the boot address. 



Example 



The boot command uses the XMODEM protocol to download a file through the active 
serial port. The program is loaded to the supplied address or to the boot address if an 
address is not specified. The program is then automatically executed. 



In this example, a Tru64 UNIX host system is connected to the motherboard on device 
/dev/ttyOl. The sx command sends a file using XMODEM. 

% echo boot 300000 > /dev/ttyOl 

% sx -kt 10 /users/evall/ciemo2/size </dev/tty01 >/dev/tty01 

Sector nnn 

% tip /dev/ttyOl 

DP264> 
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4.4.5 bootadr — Display or Modify Default Boot Address 

The bootadr command allows you to display or modify the default boot address. 



Format 
Parameters 



Example 



bootadr [address] 



address 

Specifies the starting address at which a program is loaded. Programs loaded with the 
netboot command automatically begin program execution at this address. The default 
address is SOOOOOj^. 



Description 



The boot address is the address at which your programs load and begin execution. The 
bootadr command sets the default address for the load commands to begin execution or 
to download your program into memory. If the bootadr command is specified without 
an address, the command displays the current default boot address. If you set the boot 
address value, the value is stored in battery-backed RAM. 



This example sets the starting address to 20000ig. The next file that is loaded begins 
execution from this address. 

DP2 64> bootadr 20000 
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4.4.6 bootopt — Select Operating System and Firmware 

The bootopt command selects the operating system and firmware type to be used on 
the next power-up. 



Format 



Parameters 



bootopt [type] 



type 

Specifies the operating system type. If the specified image is not found at power-up, the 
first image is booted. If there are no ROM headers, the whole ROM will be loaded at 
address 0. 



Description 



The bootopt command selects the operating system and associated firmware type that 
will be used the next time you power up your motherboard. If no type is specified, a list 
of predefined types is displayed along with the current selection. Use the romlist com- 
mand to display the images contained in the ROM. You can specify the type as a num- 
ber or a name. 



Type_number 


Type_name 


Description 





DBM 


Alpha Motherboard Debug Monitor 


1 


NT 


Windows NT 


2 


VMS 


OpenVMS 


3 


UNIX 


Tru64 UNIX 


7 


LINUX 


Linux, MILO 


8 


VXWORKS 


VxWorks 


10 


SROM 


Serial ROM 



Example 



The bootopt command can also be used to select a ROM image based on its position in 
the ROM. Specifying the type as #0 selects the whole ROM. Specifying the type as #1 
selects the first image; #2 selects the second image, and so on. 



DP2 64> bootopt 

Predefined bootoptions are... 

"0" "Alpha Evaluation Board Debug Monitor" "DBM" 

'1" "The Windows NT Operating System" "NT" 

'2" "OpenVMS" "VMS" 

'3""Tru64 UNIX" "UNIX" 

'7" "Linux" "Milo" 

'8" "VxWorks. Real-Time Operating System" "VxWorks" 

"10" "Serial ROM (SROM) " "SROM" 
0/S type selected: "OpenVMS" 
. . . .Firmware type: "Alpha SRM Console" 
DP2 64> bootopt 

0/S type selected: "Alpha Evaluation Board Debug Monitor" 
....Firmware type: "Alpha Evaluation Board Debug Monitor" 
DP2 64> bootopt nt 

0/S type selected: "The Windows NT Operating System" 
. . . .Firmware type: "Windows NT Firmware" 
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DP2 64> bootopt #1 

Firmware image 1 selected. 

. . . .Firmware type: "Unknown" 

DP2 64> bootopt unix 

0/S type selected: "Tru64 UNIX" 

. . . .Firmware type: "Alpha SRM Console" 

DP2 64> bootopt #0 

Load and boot entire ROM at address zero. 

. . . .Firmware type: "Unknown" 

DP2 64> bootopt 

Predefined bootoptions are... 

'0" "Alpha Evaluation Board Debug Monitor" "DBM" 

1" "The Windows NT Operating System" "NT" 

2" "OpenVMS" "VMS" 

3""Tru64 UNIX" "UNIX" 

7" "Linux" "Milo" 

8""VxWorks. Real-Time Operating System" "VxWorks" 

10" "Serial ROM (SROM) " "SROM" 
Load and boot entire ROM at address zero. 
. . . .Firmware type: "Unknown" 
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4.4.7 bpstat — Display Breakpoint Status 

The bpstat command displays the current breakpoint status. 

Format 

bpstat 
Parameters 

None. 

Description 

The bpstat command lists the breakpoints set with the stop command. The disassem- 
bled instructions for that location are also displayed. 

Example 



DP264> stop 200000 










DP2 64> stop 200FC0 










DP2 64> bpstat 










{break} at 00200000: 


23DEFFF0 


Ida 


sp. 


-16{sp) 


{break} at 00200FC0: 


27BB0001 


Idah 


r29. 


1 (r27) 



4-16 User Commands 8April1999 



User Commands 



4.4.8 cb — Edit Memory Bytes 

The cb command allows you to edit memory bytes (8-bit). 

Format 

cb [address] 
Parameters 

address 



Specifies the address of the memory byte you want to change. 



Description 



Example 



The cb command allows you to modify the contents of a specified memory address. If 
no address is specified, then the next byte is selected. The Debug Monitor displays the 
address followed by the current data and a colon (:). For example: 



0200090: 



ID 



To modify the contents of this memory location, type the new data after the colon and 
press the Return key. To end the editing of memory locations, type any 
nonalphanumeric character except a period (.). The nonalphanumeric character can be 
typed after the modified byte (on the same line). To leave the current location 
unchanged, press the Return key on an empty line. 



In this example, the bytes at 300000 15 and 300003 jg have been modified, leaving the 
ones at 300001 15 and 300002^5 unchanged. 



DP264> pb 300000 300008 

00300000: If 04 ff 47 If 04 ff 47 45 00 60 c3 00 00 00 00 
DP264> cb 300000 



.G.. .GE. ■ 



00300000 
00300001 
00300002 
00300003 
00300004 



If 
04 
ff 
47 
If 



aa 



dd 



DP264> pb 300000 300008 

00300000: aa 04 ff dd If 04 ff 47 45 00 60 c3 00 00 00 00 



. .GE. ' 



8April1999 



User Commands 4-17 



User Commands 



4.4.9 cfreg — Modify CPU Floating-Point Register 

The cfreg command modifies the saved CPU floating-point register state. 

Format 

cfreg register number value 
Parameters 

register_number 

Identifies the register. 
value 



Specifies the new value of the register in hexadecimal numbers. 



Description 



Example 



The cfreg command modifies the saved CPU floating-point register state to contain the 
specified value. 

The program register contents are stored in memory to the saved-state area when a 
breakpoint is encountered. Modifications to a register using the cfreg command are 
applied to that register when execution of the program is resumed using the step or the 
cont command. 



DP2 64> pfreg 

Floating Point Registers 
register file @: 0000C840 



fOO: 0000000000000000 0000000000000000 0000000000000000 
f04: 0000000000000000 0000000000000000 0000000000000000 
f08: 0000000000000000 0000000000000000 0000000000000000 
fl2: 0000000000000000 0000000000000000 0000000000000000 
fl6: 0000000000000000 0000000000000000 0000000000000000 
f20: 0000000000000000 0000000000000000 0000000000000000 
f24: 0000000000000000 0000000000000000 0000000000000000 
f28: 0000000000000000 0000000000000000 0000000000000000 
PC: OOOOOOOOOOOOOOOD PS: OOOOOOOOOOOOOOOD 
DP2 64> cfreg 12 ababababab 
DP2 64> cfreg 14 fefefefefe 
DP2 64> pfreg 
Floating Point Registers 
register file @: 0000C840 



0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 



fOO 
f04 
f08 
fl2 
fl6 
f20 
f24 
f28 
PC: 



0000000000000000 0000000000000000 0000000000000000 

0000000000000000 0000000000000000 0000000000000000 

0000000000000000 0000000000000000 0000000000000000 

OOOOOOABABABABAB 0000000000000000 OOOOOOFEFEFEFEFE 

0000000000000000 0000000000000000 0000000000000000 

0000000000000000 0000000000000000 0000000000000000 

0000000000000000 0000000000000000 0000000000000000 

0000000000000000 0000000000000000 0000000000000000 
OOOOOOOOOOOOOOOD PS: OOOOOOOOOOOOOOOD 



0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
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4.4.10 cl — Edit Memory Longwords 

The cl command allows you to edit memory longwords (32-bit). 



Format 
Parameters 

Description 



cl [address] 

address 

Specifies the address of the memory longword you want to change. 



Example 



The cl command allows you to modify the contents of a specified memory address. If 
no address is specified, then the next longword is selected. The Debug Monitor displays 
the address followed by the current data and a colon (:). For example: 

00200090: E7E0101D : 

To modify the contents of this memory location, type the new data after the colon and 
press the Return key. To end the editing of memory locations, type any 
nonalphanumeric character except a period (.). The nonalphanumeric character can be 
typed after the modified byte (on the same line). To leave the current location 
unchanged, press the Return key on an empty line. 



In this example, the memory data at address has been modified from 91E01122 to 
E7E01021. 

DP264> cl 

00000000: 91E01122: e7e01021 

DP264> pi 

00000000: E7E01021 00000000 00000000 00000000 ! 
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4.4.11 cominit — Initialize Communications Ports 

The cominit command initializes communications ports. 

Format 

cominit 
Parameters 

None. 

Description 

The cominit command initializes communications ports. 

Example 

DP2 64> cominit 
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4.4.12 compare — Compare Memory Range 



Format 
Parameters 



The compare command compares a memory range to a specified address. 
compare start_address end_ad dress compare_address 

start_address 

Specifies the memory address at which to start the comparison. 

end_address 

Specifies the last address that will be compared. 

compare_address 

Specifies the address to be compared to the memory range. 



Description 



Example 



The compare command compares each longword (32 bits) within a specified range in 
memory to another specified location. It then prints the data that differ. 



DP264> copy 3fff80000 
DP264> fill 400200 40 
DP264> fill 400400 40 
DP2 64> compare 3fff80 



3fffd0000 400000 
0220 

0440 ffffffff 
000 3fffd0000 400000 



3FFF80200: 
3FFF80208: 
3FFF80210: 
3FFF80218: 
3FFF80400: 
3FFF80408: 
3FFF80410: 
3FFF80418: 
3FFF80420: 
3FFF80428: 
3FFF80430: 
3FFF80438: 
3FFFD0000: 



64 86 00 E7 64 
7B 06 78 C3 44 
F4 9B 10 EO C3 
00 CC 00 64 83 
E2 39 37 
4B 96 16 C4 
4A 16 04 36 43 
6E OD 00 CO E2 

75 40 00 D6 76 

76 97 00 08 65 



05 49 

4A 



66 95 00 39 



79 7B 44 00 39 

FF FF FF FF FF 



00 80 FF 
AO 10 CO 
80 00 80 
00 84 74 
99 76 26 
36 B7 CI 
00 90 D6 
20 00 08 
42 00 D6 
88 00 D6 
00 80 FF 
67 99 36 
FF FF FF 



00400200: 
00400208: 
00400210: 
00400218: 
00400400: 
00400408: 
00400410: 
00400418: 
00400420: 
00400428: 
00400430: 
00400438: 
00450000: 



00 
00 
00 
00 
FF 
FF 
FF 
FF 
FF 
FF 
FF 
FF 
2D 



00 00 

00 00 
00 00 
00 00 

FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
00 00 



00 00 
00 00 
00 00 
00 00 

FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
FF FF 
00 00 



00 00 00 
00 00 00 
00 00 00 
00 00 00 
FF FF FF 
FF FF FF 
FF FF FF 
FF FF FF 
FF FF FF 
FF FF FF 
FF FF FF 
FF FF FF 
00 00 00 
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4.4.13 cont — Continue Execution from Brealtpoint 

The cont command continues execution from a breakpoint. 



Format 

Parameters 

Description 

Example 



cont 



None. 



The cont command continues from a breakpoint. The program continues until another 
breakpoint or the end of the program is reached. 



DP264> stop 100000 




DP264> go 




Executing at 0x100000... 




00100000: C1000003 br 


r8, 100010 


DP2 64> step 




00100010: 2F880007 lclq_u 


r28, 7(r8) 


DP2 64> step 




00100014: A49E0000 Idq 


r4, 0(sp) 


DP2 64> cont 




This simple program prints the sizes of 


various data types in bytes. 




char = 1 




short = 2 




int = 4 




long = 8 




float = 4 




double = 8 
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4.4.14 copy — Copy Memory Block 



Format 



Parameters 



The copy command copies the specified memory range to the new specified address. 
copy start_address end_address destination 

start_address 

Specifies the starting address for this copy. 

end_address 

Specifies the last address to be included in this copy. 

destination 

Specifies the new starting address for the memory range. 



Description 



Example 



The copy command copies the data from the specified block of memory to a new loca- 
tion in memory. The original location is unchanged. 



This example displays the original location and the destination before and after the 
copy command. 



DP264 
08000 
08000 
08000 
08000 
08000 
08000 
08000 
08000 
DP264 
09000 
09000 
09000 
09000 
09000 
09000 
09000 
DP264 
DP264 
09000 
09000 
09000 
09000 
09000 
09000 
09000 
DP264 
08000 
08000 
08000 
08000 
08000 
08000 
08000 
08000 



> pi 800 

000 
010 
020 
030 
040 
050 
060 
070 



IFl 
IFl 
IFl 
IFl 
IFl 
IFl 
IFl 
IFl 



> pi 900 

150 
160 
170 
190 
lAO 
IBO 
ICO 



000 
000 
000 
000 
000 
000 
000 



> copy 8 

> pi 900 

150 
160 
180 
190 
lAO 
IBO 
ICO 



IFl 
IFl 
IFl 
IFl 
IFl 
IFl 
IFl 
> pi 800 



000 
010 
020 
030 
040 
050 
060 
070 



IFl 
IFl 
IFl 
IFl 
IFl 
IFl 
IFl 
IFl 



0000 

FIFIF IF 
FIFIF IF 
FlFlF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
0150 

00000 00 
00000 00 
00000 00 
00000 00 
00000 00 
00000 00 
00000 00 
000000 8 
0150 

FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
0000 

FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 
FIFIF IF 



IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

000000 00000000 00000000 

000000 00000000 00000000 

000000 00000000 00000000 

000000 00000000 00000000 

000000 00000000 00000000 

000000 00000000 00000000 

000000 00000000 00000000 

000080 9000150 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 

IFIFIF IFIFIFIF IFIFIFIF 
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4.4.15 cq — Edit Memory Quadwords 



The cq command allows you to edit memory quadwords (64-bit). 



Format 



cq [address] 



Parameters 



address 

Specifies the address of the memory quadword you want to change. 



Description 



Example 



The cq command allows you to modify the contents of the specified memory address. If 
no address is specified, then the next quadword is selected. The Debug Monitor dis- 
plays the address followed by the current data and a colon (:). For example: 



00200090: 



00000000E7E0101D 



To modify the contents of this memory location, type the new data after the colon and 
press the Return key. To end the editing of memory locations, type any 
nonalphanumeric character except a period (.). The nonalphanumeric character can be 
typed after the modified byte (on the same line). To leave the current location 
unchanged, press the Return key on an empty line. 



This example modifies only quadword 200020i6. 



DP264> cq 200020 



00200020 

00200028 

00200030 

00200038 

00200040 

DP264> pq 

00200000 

00200010 

00200020 

00200030 

00200040 

00200050 

00200060 

00200070 



0000000011111111 



0000000004000000: 

0000000000000000: 

3402010400120106: 

0402010004020100: 

FBFDFEFFFFFDFEFF: ; 
200000 

FA7D7 2 99CE7F32 9 9 DA65FA99DA7D32D9 
FFFFFFFBFBFFFFDB FFFFFFFFFFFFFFFF 
0000000011111111 0000000000000000 
3402010400120106 0402010004020100 
FBFDFEFFFFFDFEFF FBFDFEFFFBFDFEFF 
CFE7FF99CB6FF7 9 9 EEE7FBFBFFFFFFFF 
0000000004 020000 0000000000000000 
1402010620100106 050A0500 04 02 010 



.2} 
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4.4.16 creg — Modify Register State 



Format 



Parameters 



The creg command modifies the saved CPU general-purpose register state. 



creg register number value 



register_number 

Identifies the register. 

value 

Specifies the new value of the register in hexadecimal numbers. 



Description 



Example 



The creg command modifies the saved CPU general-purpose register state to contain 
the specified value. 

The program register contents are stored in memory to the saved-state area when a 
breakpoint is encountered. Modifications to a register using the creg command are 
applied to that register when execution of the program is resumed using the step or cont 
command. 



DP2 64> preg 

General Purpose Re 
register file @ : 
rOO: 0000000000000020 
r04: 00000000000003F8 
r08: FFFFFC000005F470 
rl2: 208090EA6024C19C 
rl6: 0000000000100000 
r20: 0000000E20026335 
r24: 0000000000000003 
r28: FFFFFC02C0000000 
PC: OOOOOOOOOOOOOOOD 
DP264> creg 04 555 
DP2 64> preg 
General Purpose Re 
register file @ : 
rOO: 0000000000000020 
r04: 0000000000000555 
r08: FFFFFC000005F470 
rl2: 208090EA6024C19C 
rl6: 0000000000100000 
r20: 0000000E20026335 
r24: 0000000000000003 
r28: FFFFFC02C0000000 
PC: OOOOOOOOOOOOOOOD 



gisters 
000C040 

0000000000000005 OOOOOOOOOOOOCOOO 
0000000000000000 0000000000000000 
0000000000027340 0444306453605341 
882C08AA92065B2D 4100610AE100244F 
OOOOOOOOOOOOOOOD 0000000000000006 
5619A46B2B1A5125 0000000000000000 
0000000000000000 FFFFFC0000042C3C 
FFFFFC000006C1E0 0000000000FFDF40 
PS: OOOOOOOOOOOOOOOD 



gisters 
000C040 

0000000000000005 OOOOOOOOOOOOCOOO 
0000000000000000 0000000000000000 
0000000000027340 0444306453605341 
882C08AA92065B2D 4100610AE100244F 
OOOOOOOOOOOOOOOD 0000000000000006 
5619A46B2B1A5125 0000000000000000 
0000000000000000 FFFFFC0000042C3C 
FFFFFC000006C1E0 0000000000FFDF40 
PS: OOOOOOOOOOOOOOOD 



OOOOOOOOOOOOOOOD 
OOOOOOOOOOOOOOOD 
0A110C485F6EA26E 
9E2891ACA8A9D984 
0000000000000030 
OOOOOOOOOOOOOOOD 
0000000000100000 
0000000000000003 



OOOOOOOOOOOOOOOD 
OOOOOOOOOOOOOOOD 
0A110C485F6EA26E 
9E2891ACA8A9D984 
0000000000000030 
OOOOOOOOOOOOOOOD 
0000000000100000 
0000000000000003 
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4.4.17 cw — Edit Memory Words 



The cw command allows you to edit memory words (16-bit). 



Format 



cw [address] 



Parameters 



address 

Specifies the address of the memory word you want to change. 



Description 



Example 



The cw command allows you to modify the contents of the specified memory address. 
If no address is specified, then the next word is selected. The Debug Monitor displays 
the address followed by the current data and a colon (:). For example: 



00200090: 



lOlD 



To modify the contents of this memory location, type the new data after the colon and 
press the Return key. To end the editing of memory locations, type any nonalphanu- 
meric character except a period (.). The nonalphanumeric character can be typed after 
the modified byte (on the same line). To leave the current location unchanged, press the 
Return key on an empty line. 



This example modifies words 200094ig through 200098i6. 
DP264> pw 200090 



00200090 
002000A0 
002000B0 
002000C0 
002000D0 
002000E0 
002000F0 
00200100 



3BB9 CA6D FFB9 CFE7 3FBF FFFF 33F9 CE67.;m ?...3g. 

0000 0400 0000 0000 0000 0000 0000 0000 

8166 309A 4166 3402 8960 0402 8D46 359Af . . Of A. 4 ' . . .F . . 5 

FEFF FFFD FEFF FBFD FEFF FBFD FEFF FBFD 

3399 DA65 BB99 CFF7 37BF FFFF 33D9 CE67.3e 7...3g. 

0000 0000 0000 0000 0000 0000 0000 0000 

8142 2012 0166 3402 8140 0402 4504 049A B . . f . . 4@ . . . . E . . 
FEFF FFFD FEFF FBFD FEFF FBFD FEFF FBFD 



DP264> cw 200090 
00200090: 3BB9: 
00200092: CA6D : 
00200094: FFB9: ffff 
00200096: CFE7 : 0000 
00200098: 3FBF : 0101 
0020009A: FFFF: ; 
DP264> pw 200090 20009A 
00200090: 3BB9 CA6D FFFF 



0000 0101 FFFF 33F9 CE67. 



,3g. 
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4.4.18 date — Display or Modify Date and Time 

The date command displays or modifies the date and time. 



Format 
Parameters 

Description 
Example 



date [yymmddhhmmss] 

yymmddhhmmss 

To modify the date, supply the year, month, day, hour, minute, and second. 



If the date command is specified alone, the month, day, time, and year is displayed. If 
you supply a parameter, the date is modified. 



This example displays the current date and time setting. 

DP2 64> date 

Jun 1 12:58:19 1999 

These examples show how to modify the date and time setting. 

DP264> date 930211000000 

DP2 64> date 

Feb 11 00:00:04 1999 
DP264> date 930211135700 

DP2 64> date 

Feb 11 13:57:02 1999 
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4.4.19 ddmq — Deposit Quadword in Memory 

The ddmq command deposits a quadword of data in the specified memory location. 

Format 

ddmq address data [iterations] 
Parameters 

address 

Specifies the memory address. 

data 

Specifies the quadword of data to be stored. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

Description 

The ddmq command deposits the specified quadword of data in the specified memory 
location. A memory barrier (MB) instruction is executed after the store to force the 
stored data out of the chip. 



Example 



DP264> ddmq dOOOO 00000000FC04FF00 
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4.4.20 delete — Remove Breakpoint from Address 

The delete command removes a breakpoint from the specified address. 

Format 

delete address 
Parameters 

address 

Specifies the address from which to delete the breakpoint. 

Description 

The delete command removes a breakpoint from the specified address. You can use an 
asterisk (*) to remove all breakpoints. 

Example 

DP264> delete 00200050 
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4.4.21 dis — Disassemble Instructions 



Format 
Parameters 



The dis command displays memory as CPU instructions. 



dis [start_address [end_address]] 



start_address 

Specifies the address at which to start disassembling instructions. If the start_address is 
not specified, the address of the last load command, the last breakpoint, or the last dis 
command is used. 

end_address 

Specifies the address at which to end disassembling instructions. The default is the 
start_address plus 32 bytes (8 instructions). 



Description 



Example 



The dis command disassembles instructions starting with the specified address. You 
can specify an address range of instructions to be disassembled. If no parameters are 
specified, then the command starts with the current address and disassembles the next 
eight instructions. If a file is downloaded to memory, then the default starting address 
for the dis command is the first memory location in the downloaded file. If a breakpoint 
is encountered, then the default starting address is the breakpoint address. 

The rmode command is used to select whether the hardware or software register names 
are displayed when instructions are disassembled. The hardware register names are 
shown by default. The rmode setting is stored in nonvolatile RAM. 



DP264> dis 


243a0 








000243A0: 


43020122 


subl 


r24 


r2, r2 


000243A4: 


48441722 


sll 


r2. 


0x20, r2 


000243A8: 


74420050 


mt 


r2. 


cc 


00243AC: 


64630082 


mf 


r3. 


pt2 


000243B0: 


209F07E1 


Ida 


r4. 


2017 (zero) 


000243B4: 


48855724 


sll 


r4. 


0x2A, r4 


000243B8: 


44640103 


bic 


r3. 


r4, r3 


000243BC: 


47203019 


and 


r25 


0x1, r25 


DP264> dis 










000243C0: 


4B037698 


srl 


r24 


OxlB, r24 


000243C4: 


4703F118 


bic 


r24 


OxlF, r24 


000243C8: 


47190418 


bis 


r24 


r25, r24 


000243CC: 


4B055738 


sll 


r24 


0x2A, r24 


000243D0: 


44780403 


bis 


r3. 


r24, r3 


000243D4: 


746300A2 


mt 


r3. 


A2 


000243D8: 


77FF0055 


mt 


zero, flushlc 


000243DC: 


77FF0000 


mt 


zero, 


DP264> 
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4.4.22 dmb — Deposit Byte of Data in Memory 

The dmb command deposits the specified byte of data in the specified memory loca- 
tion. 

Format 

dmb address data [iterations] 
Parameters 

address 

Specifies the memory address. 

data 

Specifies the longword of data to be stored. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

Description 

The dmb command deposits the specified byte of data in the specified memory loca- 
tion. A memory barrier (MB) instruction is executed after the store to force the stored 
data out of the chip. 



Example 



DP264> dmb dOOOO FC04FF00 
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4.4.23 dmi — Deposit Longword of Data in Memory 

The dm I command deposits the specified longword of data in the specified memory 
location. 

Format 

dmI address data [iterations] 
Parameters 

address 

Specifies the memory address. 

data 

Specifies the longword of data to be stored. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

Description 

The dml command deposits the specified longword of data in the specified memory 
location. A memory barrier (MB) instruction is executed after the store to force the 
stored data out of the chip. 



Example 



DP264> dml dOOOO FC04FF00 
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4.4.24 dmq — Deposit Quadword in Memory 

The dmq command deposits the specified quadword of data in the specified memory 
location. 

Format 

dmq address data [iterations] 
Parameters 

address 

Specifies the memory address. 

data 

Specifies the quadword of data to be stored. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

Description 

The dmq command deposits the specified quadword of data in the specified memory 
location. A memory barrier (MB) instruction is executed after the store to force the 
stored data out of the chip. 



Example 



DP264> dmq dOOOO 00000000FC04FF00 
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4.4.25 dmw — Deposit Word in Memory 

The dmw command deposits the specified word of data in the specified memory loca- 
tion. 

Format 

dmw address data [iterations] 
Parameters 

address 

Specifies the memory address. 

data 

Specifies the quadword of data to be stored. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

Description 

The dmw command deposits the specified word of data in the specified memory loca- 
tion. A memory barrier (MB) instruction is executed after the store to force the stored 
data out of the chip. 



Example 



DP264> dmw dOOOO 00000000FC04FF00 
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4.4.26 ebuff — Set Memory Address for Ethernet Buffers 

The ebuff command sets the base address for the Ethernet transmit receive buffers. 

Format 

ebuff [address] 
Parameters 

address 

Specifies the address for the transmit and receive buffers. The default is lOOOOOig. 

Description 

The ebuff command sets the address in physical memory where the transmit and 
receive buffers are located. If specified without an address, this command displays the 
current location of the buffers in memory. 

Example 

DP264> ebuff 180000 
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4.4.27 edevice — Set Debug Monitor to Use Ethernet Device 

The edevice command selects the registered Ethernet device that the Debug Monitor 
will use. 

Format 

edevice [device_n umber] 
Parameters 

device number 



Specifies the net device number of any registered Ethernet device. If no device number 
is provided, the current device number is displayed. 



Description 



Example 



The edevice command sets the Debug Monitor to use one of the registered Ethernet 
devices. Use the eshow command to display all of the registered Ethernet devices. 

DP2 64> eshow 

All registered Ethernet devices: 

Net Type 
Device 

AM79C960 

1 WD3003 

2 Alpha 21340 
3* Alpha 21340 

DP2 64> edevice 1 
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4.4.28 edmp — Set Display of Packets 

The edmp command displays packets received or transmitted to the terminal screen. 

Format 

edmp [status] 
Parameters 

status 

Determines whether packets are displayed. Status can be 1 (on) or (off). 

Description 

The edmp command sets or clears the display of packets received or transmitted to the 
screen. If this command is entered with no status, then the current status is displayed. 



Example 



DP2 64> edmp 

packet dumps are OFF. 
DP2 64> eprom 1 
DP2 64> edmp 1 
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4.4.29 einit — Initialize Ethernet Controller 

The einit command initializes the Ethernet controller. 

Format 

einit 
Parameters 

None. 

Description 

The einit command initializes the Ethernet controller and displays the Ethernet hard- 
ware address. 



Example 



DP264> einit 

Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 

Init Block Address 80000 

Init Done. 

Ethernet BA-98-7 6-54-32-10 
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4.4.30 emb — Specify Display of Data 

The emb command examines and displays a byte of data in memory. 

Format 

emb address [iterations [silent]] 
Parameters 

address 

Specifies the memory address. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this parameter to 1 causes the 
data to be read but not displayed. The default is (data is displayed). 

Description 

The emb command displays a byte of data from the specified memory location. 

Example 

DP264> emb dOOOO 

FC04FF00 
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4.4.31 emi — Specify Display of Data 

The emI command examines and displays a longword of data in memory. 

Format 

emI address [iterations [silent]] 
Parameters 

address 

Specifies the memory address. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this parameter to 1 causes the 
data to be read but not displayed. The default is (data is displayed). 

Description 

The eml command displays a longword of data from the specified memory location. 

Example 

DP264> eml dOOOO 

FC04FF00 
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4.4.32 emq — Display Quadword in Memory 

The emq command examines and displays a quadword of data in memory. 

Format 

emq address [iterations [silent]] 
Parameters 

address 

Specifies the memory address. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this parameter to 1 causes the 
data to be read but not displayed. The default is (data is displayed). 

Description 

The emq command displays a quadword of data from the specified memory location. 

Example 

DP2 64> emq dOOOO 

00000000FC04FF00 
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4.4.33 emw — Display Word in Memory 

The emw command examines and displays a word of data in memory. 

Format 

emw address [iterations [silent]] 
Parameters 

address 

Specifies the memory address. 

iterations 

Specifies how many times the command is executed. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this parameter to 1 causes the 
data to be read but not displayed. The default is (data is displayed). 

Description 

The emw command displays a word of data from the specified memory location. 

Example 

DP2 64> emw dOOOO 

00000000FC04FF00 
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4.4.34 eprom — Set Flag for Receiving Pacltets 

The eprom command sets or clears a flag for receiving all packets (promiscuous 
mode). 

Format 

eprom [status] 
Parameters 

status 

Determines whether packets are displayed. Status can be 1 (on) or (off). 

Description 

The eprom command sets a flag for receiving packets. If status is set to 1 (on), then 
promiscuous mode is turned on and packets can be continuously received. If this com- 
mand is entered with no status, then the current status is displayed. The default status is 
(off). 



Example 



DP2 64> eprom 

Promiscuous Mode is DISABLED. 
DP2 64> eprom 1 
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4.4.35 ereg — Display Ethernet Controller Registers 

The ereg command displays the Ethernet controller registers. 

Format 



ereg 



Parameters 



None. 



Description 



Example 



The ereg command displays the Ethernet controller registers. This command's output is 
dependent on the Ethernet device selected for the motherboard. For example, the ISA- 
based AM79C960 controller must be in stop mode (write to register port 372 and 
write 4 to data port 370) to view most of its registers. 



DP264> vm 372 






















DP264> WW 370 4 






















DP264> ( 


areg 
























Ethernet 


Controller 


Base . 


Address 


360 


, CSR 


0... 


126 













0004 


1 


0000 


2 


0008 


3 


0000 


4 


1115 


5 


8000 


6 


1200 


7 


0000 


8 


0000 


9 


0000 


10 


0000 


11 


0000 


12 


0008 


13 


1A2B 


14 


D637 


15 


4080 


16 


0000 


17 


0008 


18 


0CC8 


19 


0008 


20 


1F88 


21 


0008 


22 


1308 


23 


0008 


24 


0018 


25 


0008 


26 


0030 


27 


0008 


28 


0028 


29 


0008 


30 


0038 


31 


0008 


32 


FFFF 


33 


FDFF 


34 


0040 


35 


0008 


36 


0018 


37 


0008 


38 


FFFF 


39 


FDFF 


40 


F9C0 


41 


8308 


42 


FFC4 


43 


0308 


44 


F9C0 


45 


8308 


46 


3CFD 


47 


FFFF 


48 


FFFF 


49 


Ffi'i' 


50 


FfbV 


51 


Ffi'i' 


52 


DFFF 


53 


/KbV 


54 


FFFF 


55 


FbFD 


56 


WbV 


57 


FVbV 


58 


Fl'i'i' 


59 


F.bbF 


60 


0038 


61 


0008 


62 


FOOO 


63 


8308 


64 


1F88 


65 


0008 


66 


FFC4 


67 


0308 


68 


8000 


69 


0235 


70 


0202 


71 


0000 


72 


FFFC 


73 


FFFF 


74 


FFFF 


75 


Fi'FF 


76 


Fi'FC 


77 


FbVb' 


78 


Ffi'E 


79 


Ffi'i' 


80 


E810 


81 


FFFF 


82 


0000 


83 


FbFF 


84 


0038 


85 


0008 


86 


FOOO 


87 


FFFF 


88 


3003 


89 


2000 


90 


FbFF 


91 


t'tYt' 


92 


FFFE 


93 


FFFF 


94 


0235 


95 


FFFF 


96 


1308 


97 


8308 


98 


F9C0 


99 


0235 


100 


FFFF 


101 


FFFF 


102 


Fi'i'F 


103 


I'i'FF 


104 


0000 


105 


0202 


106 


FfbV 


107 


Fl'i'i' 


108 


8000 


109 


0235 


110 


FFFF 


111 


FbFF 


112 


0000 


113 


FFbV 


114 


00A2 


115 


FFFF 


116 


FFFF 


117 


FFFF 


118 


FbFF 


119 


bVbV 


120 


FFFF 


121 


FFFF 


122 


FFFF 


123 


FFFF 


124 


FCOO 


125 


FFFF 


126 


0000 



























Ethernet Controller ISACSRO ... 7 

0005 1 0005 2 0003 3 0000 4 0000 5 0084 6 0008 7 0090 
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4.4.36 eshow — Display Ethernet Devices 

The eshow command displays all of the registered Ethernet devices. 



Format 

Parameters 

Description 



Example 



eshow 



None. 



The eshow command displays all of the installed device drivers and works for all of the 
motherboards. To set the Debug Monitor to use one of these devices, see the edevice 
command. An asterisk following the net device number indicates the selected Ethernet 
device to be used by the Debug Monitor Ethernet commands. 



DP2 64> eshow 

All registered Ethernet devices: 

Net Type 
Device 

AM7 9C960 

1 WD3003 

2 Alpha 21340 
3* Alpha 21340 
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4.4.37 estat — Display Ethernet Statistics 

The estat command displays Ethernet statistics. 

Format 

estat 
Parameters 

None. 

Description 

The estat command displays Ethernet statistics kept by the Ethernet device driver. 

Example 



DP2 64> estat 








sees: 


7 


mc bytes rev: 


130075 


bytes rev: 


1297171 


mc funs rev: 


625 


bytes snt: 





fjons snt dfrd: 





frms rev: 


3129 


frms snt - cllsn: 





frms snt: 





frms snt - mult cllsn: 





snd firs - xs cllsn: 





snd firs - def : 





snd firs - cc: 





rev firs - fes: 





snd firs - shrt: 





rev firs - ferr: 





snd firs - opn: 





rev firs flen: 





snd firs - flen: 





data ovrn: 





cllsn chk fir: 
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4.4.38 estop — Stop Ethernet Controller 

The estop command stops the Ethernet controller. 

Format 

estop 
Parameters 

None. 

Description 



Example 



The estop command allows you to stop sending or receiving packets from an Ethernet 
device selected with the edevice command. 



DP2 64> eshow 

All registered Ethernet devices: 

Net Type 

Device 

0* Alpha 21340 

1 AM79C960 
DP2 64> edevice 
Using network device 
DP2 64> estop 

Stopping network device in PCI slot 20: 
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4.4.39 fill — Specify Address for Fill Value 

The fill command fills a specified memory block with the specified 32-bit pattern. 

Format 

fill start_address end_address [fill_value] 
Parameters 

start_address 

Specifies the start address for the fill value. 

end_address 

Specifies the end address for the fill value. The fill value includes the end_address. 

fill value 



Specifies a longword hexadecimal number as the fill value for the specified address. 
The default is 0. 



Description 



Example 



The fill command fills a specified block of memory with a specified value. The data or 
fill value specified is placed in memory starting at the first address specified, and it fills 
through the last (or end) address specified. 



This example displays the original value in address range 08000000 through 08000080 
and the value of the same address range after the fill command. 



DP264> pi 8000000 


08000000 


E7E01021 


08000010 


00000000 


08000020 


E7E01095 


08000030 


00000000 


08000040 


00000000 


08000050 


00000000 


08000060 


00000000 


08000070 


00000000 


DP264> f 


ill 80000 


DP264> p 


1 8000000 


08000000 


IFIFIFIF 


08000010 


IFIFIFIF 


08000020 


IFIFIFIF 


08000030 


IFIFIFIF 


08000040 


IFIFIFIF 


08000050 


IFIFIFIF 


08000060 


IFIFIFIF 


08000070 


IFIFIFIF 


08000080 


IFIFIFIF 



00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 00000000 
00 8000080 Iflfl 
8000080 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

IFIFIFIF IFIFIFIF 

00000000 00000000 



00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 

flf 

IFIFIFIF 
IFIFIFIF 
IFIFIFIF 
IFIFIFIF 
IFIFIFIF 
IFIFIFIF 
IFIFIFIF 
IFIFIFIF 
00000000 
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4.4.40 flash — Program Data into Flash Memory 

The flash command programs data into flash memory. 

Format 

flash [source_address [destinationoffset [bytes_to_write]]] 

Parameters 

source_address 

Specifies the address in memory of the data to be programmed into the flash. The 
default is the default boot address (see bootadr). 

destination_offset 

Specifies the offset, in bytes, into the flash where the first byte of source data will be 
programmed. If not provided, you are prompted with a default destination_offset 
value. The destination_offset combined with the size of the data to be written must fit 
within the remaining space in the flash. Also note that ROM images containing the 
standard Makerom header must be longword aligned. See the MAKEROM chapter of 
the Alpha Microprocessors Motherboard Software Design Tools User's Guide. 

bytes_to_write 

Specifies how many bytes to write beginning at the source_address. This parameter 
causes the flash command to ignore any standard header that might be included in the 
source data. This value defaults to the value in the image size field of the standard 
header. If not specified and if there is no standard image at the beginning of the source 
data, this value is assumed to be the remaining space in the flash. 



Description 



Example 



The flash command programs the flash memory on the motherboards containing this 
type of memory. It reads data from memory at the specified source address and pro- 
grams it into the flash at the specified offset. The amount of data written can be speci- 
fied by the user or determined by the flash command. 



DP2 64> netload pc64cibm.rom 

Attempting BOOTP . . . 

Loading /users/eval/pc64 /pc54clbm. rom at 300000 
My IP address: 16.123.45.67 
Server IP address: 16.123.45.69 
###################File loaded 
DP2 64> flash 

Image source address : 0x300000 
Standard image header: Found. 

Header Size 56 bytes 

Image Checksum 0x6eeb (28395) 

Memory Image Size... 0x30B2C (199468 = 194 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 2 

Firmware ID (Opt.) . - Alpha Evaluation Board Debug Monitor 

FROM Image Size 0x30B2C (199468 = 194 KB) 

Firmware ID (Opt.).. 020000 9511221015 ..".... 

ROM offset 0x00000000 

Header Checksum 0x71fb 

Enter destination offset or press RETURN for default [0] : 
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Flash offset : 0x0 

Image size w/ header : 199524 (Segment to 3 inclusive) . 

! ! ! ! ! Warning: About to overwrite flash memory ! ! ! ! ! 
Press Y to proceed, any other key to abort. 

Update canceled by user. 

DP2 64> flash 

Image source address : 0x300000 

Standard image header: Found. 

Header Size 56 bytes 

Image Checksum 0x6eeb (28395) 

Memory Image Size... 0x30B2C (199468 = 194 KB) 

Compression Type.... 

Image Destination... 0x0000000000300000 

Header Version 2 

Firmware ID - Alpha Evaluation Board Debug Monitor 

ROM Image Size 0x30B2C (199468 = 194 KB) 

Firmware ID (Opt.).. 0200009511221015 ..".... 

ROM offset 0x00000000 

Header Checksum 0x71 fb 

Enter destination offset or press RETURN for default [0] : 40000 

Flash offset : 0x40000 

Image size w/ header : 199524 (Segment 4 to 7 inclusive) . 

! ! ! ! ! Warning: About to overwrite flash memory ! ! ! ! ! 
Press Y to proceed, any other key to abort. 

Writing Flash Block: 4W 5W 6W 7W 

Verifying Flash Block: 4V 5V 6V 7V 

DP2 64> romlist 

ROM image header found at offset: 0x040000 

Header Size 5 6 bytes 

Image Checksum 0x6eeb (28395) 

Memory Image Size... 0x30B2C (199468 = 194 KB) 

Compression Type.... 

Image Destination... 0x0000000000300000 

Header Version 2 

Firmware ID - Alpha Evaluation Board Debug Monitor 

ROM Image Size 0x30B2C (199468 = 194 KB) 

Firmware ID (Opt.).. 0200009511221015 ..".... 

ROM offset 0x00000000 

Header Checksum 0x71fb 

! Change the Image Destination field from 300000 to 400000 

! Note that because no changes were performed to the Header 

! Checksum field after the change, a header checksum 

! error will be reported with romlist. 

DP264> dml 500000 400000 

DP264> flash 500000 40018 4 

Image source address : 0x500000 

Flash offset : 0x40018 

Data image size : 4 (Segment 4 to 4 inclusive) . 

! ! ! ! ! Warning: About to overwrite flash memory ! ! ! ! ! 
Press Y to proceed, any other key to abort. 

Writing Flash Block: 4W 
Verifying Flash Block: 4V 
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DP2 64> romlist 

ROM image header found at offset: 0x040000 

Header Size 56 bytes 

Image Checksian 0x6eeb (28395) 

Memory Image Size... 0x30B2C (199468 = 194 KB) 

Compression Type. ... 

Image Destination... 0x0000000000400000 

Firmware ID - Alpha Evaluation Board Debug Monitor 

ROM Image Size 0x30B2C (199468 = 194 KB) 

Firmware ID (Opt.).. 0200009511221015 ..".... 

ROM offset 0x00000000 

Header Checksum 0x71fb 

ERROR: Bad ROM header checksum. 0x79fb 
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4.4.41 flasherase — Erase Data from Flash Memory 



The flasherase command erases data from flash memory. 



Format 



flasherase [startingoffset [bytes_to_erase]] 



Parameters 



start! ng_off est 

Specifies the offset, in bytes, into the flash where data will be erased. If not provided, 
the entire flash will be erased. 

bytes_to_erase 

Specifies how many bytes to erase. If not specified, all bytes from the starting_offset 
through the rest of the flash will be erased. 



Description 



Example 



The flasherase command clears flash memory on boards equipped with flash. The area 
to be erased, that is, filled with zeros, can be specified or calculated by the flasherase 
command. 



DP2 64> romlist 

ROM image header found at offset: 0x000000 

Header Size 0x38 (56) bytes 

Image Checksum 0x45b0 (17840) 

Memory Image Size... 0xBA40 (47680 = 46 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 2 

Firmware ID 6 - Alpha Evaluation Board Fail-Safe Booter 

ROM Image Size 0xBA40 (47680 = 46 KB) 

Firmware ID (Opt.).. 020200 9702121228 ( 

ROM offset 0x00000000 

Header Checksum 0xfad4 

ROM image header found at offset: 0x010000 

Header Size 0x38 (56) bytes 

Image Checksum 0xc63c (50748) 

Memory Image Size... 0x280B4 (164020 = 160 KB) 

Firmware ID (Opt.).. 020200 9706130904 

ROM offset 0x00000000 

Header Checksum 0x94a5 

DP2 64> flasherase 40000 

Flash offset : 0x40000 

Bytes to be erased : 786432 (Block 4 to 15 inclusive) . 

! ! ! ! ! Warning: About to overwrite flash memory ! ! ! ! ! 
Press Y to proceed, any other key to abort. 
Writing Flash Block: 4V 5V 6V 7V 8V 9V lOV IIV 12V 13V 14V 15V 
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4.4.42 fiboot — Download and Execute File from Diskette 

The f I boot command downloads the specified file from the diskette and begins execu- 
tion of that file. 

Format 

fiboot file [address] 
Parameters 

file 

Specifies the name of the file to access on the diskette. 

address 

Specifies the address at which to load the file. The default is the boot address. 

Description 

The flboot command downloads the specified file into the specified address or the boot 
address. The downloaded file automatically begins execution in PALmode as if a jtopal 
command had been entered. 



Example 



DP2 64> fiboot size2 

High Density selected 

size2 . 20 bytes 11/21/1999 13:42:20 

loading . . . 

cluster: 2 sector: 33 buffer: 200000 

done . . . 

Jumping to 0x200000... 
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4.4.43 fled — Display or Change Working Directory or Drive 



The fled command displays or changes the current working directory or drive. 



Format 



fled [drive_pathname] 



Parameters 



drive_pathname 

Specifies the new drive and working directory. 



Description 



Example 



The fled command allows you to change the current working directory for the current 
drive. It can also be used to switch to a different default drive. If no parameters are 
specified, then the default drive and working directory are displayed. 

Drives are specified by using the letters A through Z. The path is a list of subdirectories 
separated by a slash (/) for Tru64 UNIX users or a backslash (\) for DOS users. The top- 
level directory (known as the root directory) is represented by a slash (/) or backslash 
(\). A path can be an absolute or relative path. An absolute path begins with the root 
directory, whereas a relative path begins with the current working directory. 

Subdirectory entries also contain two special entries that can be used to specify a path. 
One period (.) represents the current directory and two periods (..) represent the direc- 
tory above the current level. 



DP264> fled 

a:\ 

DP264> fldir 

High Density selected 

10/04/99 02:07p 

10/04/9999 02:08p 

10/06/99 10:05a 

10/06/99 10:05a 



DP2 64> fled dirl 

a:\clirl\ 

DP264> fldir 

High Density selected 

10/06/99 10:05a 

10/06/99 10:05a 

10/06/99 10:05a 

DP2 64> fled /dirl/dir2 

a : \dirl\dir2\ 
DP264> fldir 
High Density selected 
10/06/99 10:05a 
10/06/99 10:05a 

DP2 64> fled ../../dir3 

a:\dirl\dir2\. .\. .\dir3\ 
DP264> fldir 
High Density selected 
10/06/99 10:05a 
10/06/99 10:05a 
04/28/99 05:50p 

DP264> fled b: 

b:\ 

DP264> fldir 



2030 88 rom.cmp 
203140 rom.rom 
<DIR> dirl 
<DIR> dir3 

1048576 bytes free 



<DIR> 
<DIR> 
<DIR> dir2 

1048576 bytes free 



<DIR> 
<DIR> 

1048576 bytes free 



<DIR> 
<DIR> 

71 diff.lst 
1048576 bytes free 
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High Density selected 
09/07/99 10:28a 
10/03/99 05:59p 



6688 srom 
202 980 rom.rom 
1247232 bytes free 
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4.4.44 ficopy — Copy File 

The f Icopy command copies a file to another location. 

Format 

ficopy source_file destinationfile 
Parameters 

source_file 

Specifies the file to be copied. If no drive and path are specified, the default drive and 
path are used. 

destination_file 

Specifies the name of the copied file. If no drive and path are specified, the default 
drive and path are used. Note that a destination file name must always be specified, 
even if copying to a subdirectory. 



Description 



Example 



The ficopy command allows you to copy a file to another destination. An optional drive 
and path specification may be specified for either the source or destination file name. If 
they are not specified, then the default drive and path are used. 



DP264 

a : \cli 

DP264 

High 

10/06 

10/06 

04/28 

DP264 

High 

Copyi 

Done . 

DP264 

High 

10/06 

10/06 

10/06 

DP264 

High 

High 

Copyi 

Done . 

DP264 

High 

09/07 

10/03 

10/06 



> fled \dir3 

r3\ 

> fldir 

Density selected 
/99 10:05a 
/99 10:05a 
/99 05:50p 

> ficopy diff.lst 

Density selected 
ng files . . . 



<DIR> 
<DIR> 

71 diff.lst 
1048064 bytes free 
. \dirl\dir2\dif f2 . 1st 



> fldir . .\dirl\dir2\ 

Density selected 
/99 10:05a <DIR> 

/99 10 :05a <DIR> 

/99 10:48a 71 dif f 2 . 

1047552 bytes 

> ficopy diff.lst b:\diff2.1st 
Density selected 

Density selected 
ng files . . . 



1st 
free 



> fldir b:\ 

Density selected 
/99 10:28a 
/99 05:59p 
/99 10:53a 



6688 srom 

2 02 980 rem. rem 

71 diff2.1st 

1246720 bytes free 



4-56 User Commands 



8 April 1999 



User Commands 



4.4.45 fidir — Display File Listing 



The f Idir command displays a list of files in the current or specified directory. 



Format 



fIdir [drive_pathname] 



Parameters 



drive_pathname 

Specifies the drive or subdirectory. 



Description 



Example 



The fldir command displays a directory of files in the current or specified directory. 

Drives are specified by using the letters A through Z. The path is a list of subdirectories 
separated by a slash (/) for Tru64 UNIX users or a backslash (\) for DOS users. The top- 
level directory (known as the root directory) is represented by a slash (/) or backslash 
(\). A path can be an absolute or relative path. An absolute path begins with the root 
directory, whereas a relative path begins with the current working directory. 

Subdirectory entries also contain two special entries that can be used to specify a path. 
One period (.) represents the current directory and two periods (..) represent the direc- 
tory above the current level. 



DP264> fled 
a:\ 










DP264> fldir 










High Density 


selected 








10/04/99 02: 


:07p 


203088 


rom. cmp 


10/04/99 02: 


:08p 


203140 


rom. rom 


10/06/99 10: 


:05a 


<DIR> 


dirl 




10/06/99 10: 


:05a 


<DIR> 


dir3 








1048064 


bytes 


free 


DP264> fldir 


/dirl 








High Density 


selected 








10/06/99 10: 


:05a 


<DIR> 


. 




10/06/99 10: 


:05a 


<DIR> 






10/06/99 10: 


:05a 


<DIR> 


dir2 








1048064 


bytes 


free 



DP2 64> fled dirl\dir2 

a : \dirl\dir2\ 

DP2 64> fldir . . \ . . \dir3 

High Density selected 
10/06/99 10:05a 
10/06/99 10:05a 
04/28/99 05:50p 

DP264> fldir b:\ 
High Density selected 
09/07/99 10:28a 
10/03/99 05:59p 



<DIR> 
<DIR> 

71 diff.lst 
1048064 bytes free 



6688 srom 
2 02 980 rom. rom 
1247232 bytes free 
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4.4.46 flload — Download File from Diskette 

The flload command downloads the specified file from the diskette. 

Format 

flload file [address] 
Parameters 

file 

Specifies the name of the file to access on the diskette. 
address 

Specifies the address at which to load the file. The default is the boot address. 
Description 

The flload command downloads the specified file into the specified address or the boot 
address. The program can then be executed with the go or jtopal commands. 



Example 



DP2 64> bootadr 

00200000 

DP2 64> flload size2 

High Density selected 

size2 . 20 bytes 11/21/1999 13:42:20 

loading . . . 

cluster: 2 sector: 33 buffer: 200000 

done . . . 
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4.4.47 firead — Read Logical Sectors from Diskette 

The firead command reads logical sectors from a diskette. 

Format 

firead [first_sector [bytes [dest_address [iterations [drive]]]]] 
Parameters 

first_sector 

Specifies the first logical sector of diskette to read. The default is sector (the boot sec- 
tor). 

bytes 

Specifies the number of bytes to be read from the diskette. The default sector is one sec- 
tor. 

dest_address 

Specifies the beginning address where data will be loaded. The default is the boot 
address. 

iterations 

Specifies the number of times to repeat the reading of the sector range. The default 
is 1. 

drive 

Specifies the diskette drive number to use: or 1. The default is 0. 



Description 



The firead command reads the data from the specified logical sectors of a diskette into 
memory. The iterations parameter can be used to repeat the task a specified number of 
times. 



Example 



DP2 64> firead 1 










High 


Density 


selected 










Reading byt 


:es to Ox 


.300000 starting at 


sector 1 . 




Done . 


. . . 512 1 


:0X200) bytes transferred 








DP2 64> firead 1 1500 










High 


Density 


selected 










Reading 1500 


bytes to 


0x300000 starting 


at 


sector 


1 


Done , 


. .. 1536 


(0X600) 


bytes transferred 








DP2 64> firead 1 1500 


400000 








High 


Density 


selected 










Reading 1500 


bytes to 


0x400000 starting 


at 


sector 


1 


Done , 


. .. 1536 


(0X600) 


bytes transferred 








DP2 64> firead 1 1500 


400000 3 








High 


Density 


selected 










Reading 1500 


bytes to 


0x400000 starting 


at 


sector 


1 


Done , 


. .. 1536 
2 it 


(0X600) 
aerations 


bytes transferred 
remaining 








Done , 


. .. 1536 

1 it 


(0X600) 
aerations 


bytes transferred 
remaining 








Done , 


. .. 1536 


(0X600) 


bytes transferred 
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4.4.48 fisave — Write Memory Range to File 

The f Isave command writes a memory range to a file. 



Format 
Parameters 



fisave file_name start_address file_size 

file_name 

Specifies the name of the file to be created with the data. If no drive or path is specified, 
the file is created in the default working directory. 

start_address 

Specifies the address in memory to start writing to the file. 

file_size 

Specifies the size in bytes of the file to write. 



Description 



Example 



The flsave command writes a section of memory to a file. The file name can specify a 
drive and path. 



DP264> fisave test.txt 300000 34526 

High Density selected 

Saving range 0x300000 to 0x334525 to file test.txt 

DP264> fisave b:\test.txt 300000 34526 

High Density selected 

Saving range 0x300000 to 0x334525 to file b:\test.txt 
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4.4.49 flwrite — Write Data to Diskette's Logical Sectors 

The flwrite command writes data to logical sectors on a diskette. 

Caution: This is a destructive command. You must be careful which 

sectors you write to because you may render the disk unusable. 



Format 
Parameters 



flwrite [first_sector [image_size [source_address [iterations [drive]]]]] 



first_sector 

Specifies the first logical sector of diskette to be written. The default is sector (the 
boot sector). 

image_size 

Specifies the number of bytes to write to the diskette. The default is one sector. 

source_address 

Specifies the beginning address where data to be written resides. The default is the boot 
address. 

iterations 

Specifies the number of times to repeat the writing of the sector range. The default 
is 1. 

drive 

Specifies the diskette drive number to use: or 1. The default is 0. 



Description 



Example 



The flwrite command writes data from memory to the specified logical sectors of a dis- 
kette. 

The iterations parameter can be used to repeat the task a specified number of times. 



DP2 64> flwrite 30 

High Density selected 

Writing bytes from 0x400000 starting at sector 30. 

Done... 512 (0X200) bytes transferred 

DP2 64> flwrite 30 3400 

High Density selected 

Writing 3400 bytes from 0x400000 starting at sector 30. 

Done... 3584 (OXEOO) bytes transferred 

DP264> flwrite 30 3400 300000 

High Density selected 

Writing 3400 bytes from 0x300000 starting at sector 30. 

Done... 3584 (OXEOO) bytes transferred 

DP264> flwrite 30 3400 300000 2 

High Density selected 

Writing 3400 bytes from 0x300000 starting at sector 30. 

Done... 3584 (OXEOO) bytes transferred 

1 iterations remaining 
Done... 3584 (OXEOO) bytes transferred 
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4.4.50 fwupdate — Load and Run Firmware Update from Diskette 

The fwupdate command loads and runs the firmware update utihty from diskette. 

Format 

fwupdate 
Parameters 

None. 

Description 

The fwupdate command loads and executes the firmware update utility (fwupdate.exe) 
from diskette. The utility gets loaded into physical address 900000i6 (physical location 
9 MB), and gets executed in PALmode. 

This command expects the diskette to be formatted with a FAT file structure. 

Example 

DP2 64> fwupdate 

...follow instructions to update firmware for 

Windows NT Firmware, the Debug Monitor, or the Alpha SRM Console . . . 
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4.4.51 go — Begin Executing Instructions 

The go command begins execution of instructions at the specified address. 

Format 

go [start_address] 
Parameters 

start_address 

Specifies the address at which to start executing the instructions. 

Description 

The go command jumps to a location in memory and begins executing instructions. If 
no address is specified, then the execution of instructions begins at the boot address. 

Example 

This example starts executing instructions at address 100000 jg. 
DP264> go 100000 



8 April 1999 User Commands 4-63 



User Commands 

4.4.52 help — Display Command Information 

The help command displays a list of commands currently available. If you specify a 
command keyword, information about the specified command is displayed. 



Format 
Parameters 



h[elp] [com mand_key word] 



com mand_key word 



Indicates any command name that appears in the list when you type the help command. 
An asterisk (*) displays help for all commands. 



Description 



Example 



The help command displays a list of command keywords implemented in the current 
release. The command can be abbreviated to one letter, h. If you specify a command 
with a command keyword, then a brief description and syntax for the specified com- 
mand is displayed. You can use an asterisk (*) in place of a command keyword to dis- 
play all help information. 



The help command without a parameter displays a list of all commands implemented in 
the current version of the software. When specified with a parameter, it displays more 
information about that command keyword. 

DP2 64> help 

A brief help description is available for each of the 
following commands. 



load 


boot 


netload 


netboot 




fled 


f Icopy 


fldir 


flboot 


flload 


flread 




f Iwrite 


f Isave 


romboot 


romlist 


romload 


romveri 


fy 


bootadr 


bootopt 


go 


jtopal 


init 


emb 




emw 


eml 


emq 


ddmq 


dmb 


dmw 




dml 


dmq 


pq 


Pl 


pw 


pb 




cq 


cl 


cw 


cb 


fill 


copy 




compare 


dis 


sum 


rl 


rw 


rb 




wl 


WW 


wb 


mrl 


mrw 


mrb 




mwl 


mww 


mwb 


sq 


si 


sw 




sb 


pcishow 


prl 


prw 


prb 


pwl 




pww 


pwb 


flash 


f lasherase 


fwupdate 


date 




apropos 


help 


h 


ident 


version 


sysshow 




swpipl 


mces 


wrf en 


preg 


pf reg 


creg 




cf reg 


stop 


bpstat 


next 


n 


step 




s 


cont 


delete 


ladebug 


lack 


rmode 




setty 


setbaud 


tip 


cominit 


vinit 


edevice 




eshow 


ereg 


estat 


einit 


estop 


ebuff 




edmp 


eprom 


arpshow 


mcheck 


beep 


memtest 




mt 






Hit any key t 


o continue. 


Control- 


-C to 


quit . . . 




DP264> 


help * 













Displays help for all commands in the command list. 
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4.4.53 Jack — Perform Interrupt Acknowledge Cycle 

The iack command performs an interrupt acknowledge cycle. 

Format 

iack 
Parameters 

None. 

Description 



Example 



The iack command allows you to perform an interrupt acknowledge cycle. Two iack 
commands are required to read the interrupt vector. 



DP2 64> iack 

FF 

DP264> iack 

07 
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4.4.54 ident — Identify Revision of Files 

The ident command displays revision control system (RCS) ID strings found in the 
specified memory range. 



Format 



Parameters 



ident [start_address [end_address]] 



start_address 

Specifies a hexadecimal number that represents a legal address at which to start search- 
ing for RCS keywords. The default value is the boot address. 

end_address 

Specifies a hexadecimal number that represents a legal address at which to end the 
search for RCS keywords. The default value is the boot address plus VOjg. 



Description 



Example 



The ident command identifies the revision of files used to build images that were 
loaded into memory by searching for all occurrences of the pattern $keyword: ...$ in the 
specified memory range. This command is based on the assumption that RCS was used 
for version control on the source files on the host development system. RCS is supplied 
with the Tru64 UNIX operating system. 



DP2 64> ident 



Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 
Id 



crt_star 
crt . c, V 
dis . c, V 
f f exec . c 
f f srec . c 
cmd . c, V 
pReg. c, V 
rw . c, V 1 
netboot . 
amd . c, V 
tftp . c, V 
netutil . 
boots . c, 
listener 
kernel . c 
bptable . 
kutil . s, 
comms . c, 
server_r 
packet-h 
printf . c 



80000 

tup . s, V 
1.1 1999 

1.1 1999 
,v 1.2 1 
,v 1.1 1 
1. 6 1999 

1.1 199 
.1 1999/ 
c, V 1.1 

1.2 1999 
1.1 199 

c, V 1.1 

V 1.2 19 
. c, V 1.2 
, V 1.5 1 
c, V 1.1 

V 1.1 19 

V 1.2 19 
ead_loop 
andling . 

V 1. 1 1 



1.3 1 
/06/0 
/06/0 
999/0 
999/0 
/06/1 
9/06/ 
06/08 
1999/ 
/06/0 
9/06/ 
1999/ 
99/06 
1999 
999/0 
1999/ 
99/06 
99/06 
. c, V 
c, V 1 
999/0 



99 



9/06/18 20:30:03 fdh Rel $ 
19:56:39 fdh Rel $ 
19:56:40 fdh Rel $ 
09 20:23:05 fdh Rel $ 
08 19:56:41 fdh Rel $ 
17:32:36 fdh Rel $ 

19:56:41 fdh Rel $ 
9:56:42 fdh Rel $ 
/08 19:56:30 fdh Rel $ 
22:32:57 berent Rel $ 

19:56:31 fdh Rel $ 
/08 19:56:31 fdh Rel $ 
8 22:32:57 berent Rel $ 
6/08 22:32:57 berent Rel $ 
18 17 :49:34 fdh Rel $ 
/08 19:56:33 fdh Rel $ 
8 19:56:36 fdh Rel $ 
8 22:32:06 berent Rel $ 
1 1999/06/08 19:56:38 fdh Rel $ 

1999/06/08 22:32:06 berent Rel $ 
08 19:56:24 fdh Rel $ 



Hit any key to continue. Control-C to quit. 
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4.4.55 init — Reinitialize the Debug Monitor 

The init command reinitializes the Debug Monitor. 

Format 

init 
Parameters 

None. 

Description 



Example 



The init command restarts the Debug Monitor by jumping to the PALcode base address 
in PALmode. It is analogous to using the jtopal command with the PALbase address. 



DP2 64> init 

Stopping network device in PCI slot IE 

Jumping to 0x000000... 

========== Starting Debug Monitor! ! ! 



8 April 1999 User Commands 4-67 



User Commands 



4.4.56 jtopal — Set to PALmode and Execute Instructions 

The jtopal command sets the environment to PALmode and begins execution of 
instructions at the specified address. 



Format 
Parameters 



jtopal [start_address] 



start address 



Specifies the address at which to start executing instructions. The default is the boot 
address. 



Description 



Example 



The jtopal command emulates the hardware mechanism for entering PALcode. When 
instructions contain PALcode, you must set the environment to PALmode to properly 
execute instructions. This command is required for executing downloaded images 
entered in PALmode, such as a serial ROM or debug ROM image. The jtopal com- 
mand sets the environment to PALmode and then jumps to the specified location in 
memory to begin executing instructions. 



This example starts executing instructions at address lOOOOOig. 
DP264> jtopal 100000 
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4.4.57 ladebug — Start Ladebug Remote Debugger 

The ladebug command starts the Ladebug server for a remote debug session. 



Format 

Parameters 

Description 



Example 



ladebug 



None. 



The ladebug command configures the motherboard as a remote debugger target. You 
can connect to the motherboard from the Ladebug source-level debugger running on a 
Tru64 UNIX host. Communication is performed through the Ethernet connection. The 
Ladebug software provides the full source-level debugging capabilities of most pro- 
grams running on the motherboard, including the Debug Monitor. 

To debug a program running on a motherboard using Ladebug running on a remote 
host, follow these steps: 

1 . Load the program into memory on the motherboard. 

2. Set a breakpoint in the program. 

3. Execute the program. The program will stop at the breakpoint and print the instruc- 
tion line at that location. 

4. Issue the ladebug command. This causes the motherboard to wait for a connection 
from Ladebug. 

5. From the host system, enter the command to start up Ladebug and cause it to con- 
nect to the motherboard. 

Refer to the Ladebug documentation for more information. 



DP2 64> netload size 

Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 

Init Block Address 100000 

Init Done. 

Ethernet BA-98-7 6-54-32-10 

Attempting BOOTP ... success . 

my IP address: 16.123.45.67 
server IP address: 16.123.45.69 
gateway IP address: 16.123.45.69 
Loading from /users/eval/boot/size . . . 
#### 

DP264> stop 200000 
DP264> go 
Executing at 0x200000... 

00200000: 23DEFFF0 Ida sp, -16 (sp) 
DP2 64> ladebug 

Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 

Init Block Address 100000 

Init Done. 

Client connected : client is FFFFFFFFA0107F10 
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The following command, entered from the host system, starts Ladebug and causes it to 
connect to the DP264: 

% ladebug size. out -rn dp264 -pid 
The following information is displayed on the host system: 

Welcome to the Ladebug Debugger Version 1.3.1 



object file name: size. out 
machine name: cip2 64 
process id: 

Reading symbolic information ...done 
Connected to remote debugger 
(ladebug) 

The (ladebug) in the previous example is the Ladebug prompt. You are now ready to 
debug a process that is running on the DP264. 
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4.4.58 load — Download File Using XMODEM Protocol 



The load command downloads a file through the active serial port using the XMODEM 
protocol. 



Format 
Parameters 

Description 



load [address] 

address 

Specifies the address at which to download the file. The default is the boot address. 



Example 



The load command uses the XMODEM protocol to download a file through the active 
serial port. The program is loaded to the supplied address or the boot address if an 
address is not specified. The program can then be executed with the go or jtopal com- 
mands. 



In this example, a Tru64 UNIX host system is connected to the motherboard on device 
/dev/ttyOl. The sx command sends a file using XMODEM. 

% echo load 300000 > /dev/ttyOl 

% sx -kt 10 /users/evall/demo2/size </dev/ttya01 >/dev/tty01 

Sector nnn 
%tip /dev/ttyOl 

DP264> 
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4.4.59 mces — Set or Display Machine Checl( Error Summary 

The mces command sets or displays the machine check error summary register. 

Format 

mces [mces_data] 
Parameters 

mces_data 

Specifies the value to be written to the machine check error summary register. 

Description 

The machine check error summary register controls machine check and system-correct- 
able error handling. The mces command provides direct user access to the rdmces and 
wrmces PALcode instructions that are defined by the Alpha Architecture Reference 
Manual. 



Example 



This register is also affected by the mcheck command. 



In the following example, a zero is written to the machine check error summary regis- 
ter: 

DP2 64> mces 

Machine Check Error Summary: 08 
DP2 64> mces 

Machine Check Error Summary: 00 
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4.4.60 mcheck — Control Machine Checks 



The mcheck command controls the reporting of hardware error conditions (machine 
checks). 



Format 
Parameters 



mcheck state 

state = on 

Enables all machine check reporting. 

State = off 

Disables all machine check reporting. 

State = system 

Enables machine check reporting for hardware errors detected external to the CPU. 

State = cpu 

Enables machine check reporting for hardware errors detected by the CPU. 



Description 



The mcheck command controls the reporting of hardware error conditions. A machine 
check indicates that a hardware error condition was detected. Different error conditions 
are detected by the CPU or system logic external to the CPU. To help to ensure the 
availability of the Debug Monitor for hardware debug, machine check reporting is dis- 
abled when the Debug Monitor starts up. This condition makes the Debug Monitor 
firmware more fail-safe than conventional firmware when hardware integrity is ques- 
tionable. Therefore, when using the Debug Monitor, machine checks can be enabled on 
demand by the mcheck command to facilitate low-level hardware debug. 

Because some machine checks are reported through interrupt requests at interrupt prior- 
ity level (IPL) 6, the mcheck command could change the current IPL. If the current IPL 
is lower than 7, the current IPL will not be affected. See the description of the swpipl 
command for more information about the IPL. 

The mcheck command could also modify the machine check error summary register. 
See the mces command for more information about the machine check error summary 
register. 
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In the following example, all machine check and correctable error reporting are enabled 
before running the memory test. The errors displayed in this example are correctable, 
and without machine checks enabled, these memory errors would be corrected by the 
CPU. 

DP2 64> mcheck on 

Old BC_CTL = 0x00028051 & BC_CFG = 0x01E21772 

New BC_CTL = 0x00020041 & BC_CFG = 0x01E21772 

CIA_CACK_EN = 0x8 & CIA_MCR = Ox2001FE21 

DP2 64> mces 

Machine Check Error Summary: 00 

DP2 64> memtest 

Walking I's ... range 0x0008a420 : 0x03f f cOOO 

Processor Correctable Machine Check: Interrupt vector = 0x630 

EI_STAT: FFFFFFF0C4FFFFFF EI_ADDR: FFFFFFOO 001231AF 
FILL_SYNDROME: 00 00 000 00 00 0019 ISR: 0000000100600000 

Processor Correctable Machine Check: Interrupt vector = 0x630 

EI_STAT: FFFFFFF0C4FFFFFF EI_ADDR: FFFFFFOO 00 9231AF 
FILL SYNDROME: 00 00 000 00 00 0019 ISR: 0000000100600000 
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4.4.61 memtest — Perform Tests on Memory Range 

The memtest command tests a memory range. 

Format 

memtest [iterations [start_address [end_address [increment [mciieck [stop drivers M] 

Parameters 

iterations 

Specifies tiie number of times the memory range test will run. The default iteration 
is 1. 

start_address 

Specifies the address at which to start the memory test. The default is the current 
address. 

end_address 

Specifies the address at which to end the memory test. 

increment 

Defines the step size. The default is longword access (4). 

mchecit 

Specifies the machine check state as defined by the mcheck command (see the mcheck 
command). The mcheck state is specified during the start of the memory test. Possible 
selections are: on, off, cpu, and system. The default is on. 

stop_d rivers 

Specifies if device drivers should be stopped before the start of the memory test. A non- 
zero value stops all device drivers. A zero value specifies that drivers should not be 
stopped. The default is stopped. 



Description 



Example 



The memtest command performs a set of memory tests on the specified address range. 
This test uses longword accesses to memory. The tests include walking Is and walking 
Os as well as alternating Is and Os. 

While conducting the memory test, correctable read data errors may be encountered, 
indicating memory integrity problems. However, if hardware error reporting is dis- 
abled, the CPU corrects the correctable errors without reporting them. To alleviate this 
problem, the mcheck parameter must specify the machine check conditions while run- 
ning the memory test. 

Device drivers that use main memory for DMA access while the memory test is running 
may cause unpredictable results. To prevent the memory test from conflicting with the 
device drivers, the stop_drivers parameter must be set to a 
nonzero value. 



DP2 64> memtest 2 8000000 Sffffff 4 on 1 
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4.4.62 mrb — Display Byte from Memory I/O Space 

The mrb command reads a byte from memory in the register port in I/O address space. 

Format 

mrb address [iterations [silent]] 
Parameters 

address 

Specifies the address in memory I/O space. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



The mrb command displays the byte from the specified memory location in the mem- 
ory I/O space. For example, on the DP264, the byte is read from the ISA extension slot. 



Example 



DP2 64> mrb dOOOO 

FF 
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4.4.63 mrl — Display Longword from Memory I/O Space 

The mrl command reads a longword from memory in the register port in I/O address 
space. 

Format 

mrl address [iterations [silent]] 
Parameters 

address 

Specifies the address in memory I/O space. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



The mrl command displays the longword from the specified memory location in the 
memory I/O space. For example, on the DP264, the longword is read from the ISA 
extension slot. 



Example 



DP264> mrl dOOOO 

FC04FF00 
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4.4.64 mrw — Read Word from Memory I/O Space 

The mrw command reads a word from memory in the register port in I/O address 
space. 

Format 

mrw address [iterations [silent]] 
Parameters 

address 

Specifies the address in memory I/O space. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



Example 



The mrw command displays the word from the specified memory location in the mem- 
ory I/O space. For example, on the DP264, the word is read from the ISA extension 
slot. 



DP264> mrw dOOOO 
FFOO 
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4.4.65 mt — Measure Memory Bandwidth 

The mt command measures memory bandwidth. 

Format 

mt 
Parameters 

None. 

Description 

The mt command measures memory bandwidth. 

Example 

DP2 64> mt 
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4.4.66 mwb — Write Byte to Memory I/O Space 

The mwb command writes a byte to memory in the register port in I/O address space. 

Format 

mwb address data [iterations] 
Parameters 

address 

Specifies the address in memory I/O space where the byte is written. 

data 

Specifies byte data. 

iterations 

Specifies how many times the data is read. The default is 1 . 

Description 

The mwb command specifies the memory location in I/O memory space to write data 
in byte format. 



Example 



DP264> mrb dOOOO 

FF 

DP2 64> mwb dOOOO 

DP264> mrb dOOOO 

00 
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4.4.67 mwl — Write Longword to Memory I/O Space 

The mwl command writes a longword to memory in the register port in I/O address 
space. 

Format 

mwl address data [iterations] 
Parameters 

address 

Specifies the address in memory I/O space where the longword is written. 

data 

Specifies longword of data. 

iterations 

Specifies how many times the data is read. The default is 1 . 

Description 

The mwl command writes a longword to memory in I/O address space. For example, on 
the DP264, the longword is written to the ISA extension slot. 

Example 

DP264> mwl dOOOO fc04ff00 
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4.4.68 mww — Write Word to Memory I/O Space 

The mww command writes a word to memory in the register port in I/O address space. 

Format 

mww address data [iterations] 
Parameters 

address 

Specifies the address in memory I/O space where the word is written. 

data 

Specifies word of data. 

iterations 

Specifies how many times the data is read. The default is 1 . 

Description 

The mww command writes a word to memory I/O space. For example, on the DP264, a 
word is written to the ISA extension slot. 



Example 



DP264> mrw dOOOO 

FFOO 

DP2 64> mww dOOOO a5a5 

DP264> mrw dOOOO 

A5A5 
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4.4.69 netboot — Download and Execute File 



The netboot command downloads the specified file through the Ethernet port and 
begins execution of that file. 



Format 



netboot [file [address]] 



Parameters 



file 

Specifies a legal file name to be downloaded to the motherboard. The default is to load 
the file specified in the bootptab file. 

address 

Specifies the address at which to download the file. The default is the boot address. 



Description 



Example 



The netboot command uses BOOTP to download the specified file through the Ether- 
net port. The Ethernet port is selected through the edevice command. The downloaded 
file automatically begins execution in PALmode. This command has the same effect as 
using the netload command followed by the jtopal command. 

A default file and directory path may be defined in the bootptab file. See 
Section 2.3.4.2 for more information. 

If you specify an address, this address becomes the default boot address. This value, 
however, is not set in battery -backed RAM. 



This example downloads and begins execution of a file called size. 



DP2 64> netboot size 

Ethernet Base Address: 360, 
Init Block Address 80000 
Init Done. 

Ethernet BA-98-7 6-54-32-10 
Attempting BOOTP ... success . 

my IP address: 16.123. 
server IP address: 16.123. 
gateway IP address: 16.123. 
Loading from /users/eval/boot /size 
### 
Jumping to 0x100000... 



DMA Mask: 



.45.67 
.45.69 
.45.69 



DRQ5 



char = 


1 


short = 


2 


int 


4 


long 


8 


float 


4 


double = 


8 



Alpha 21264 Evaluation Board (DP264) Debug Monitor 
Version: Wed Feb 10 19:52:24 EST 1999 
Bootadr: 0x100000, memSize: 0x2000000 
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4.4.70 netload — Download File to Default Boot Address 



The netload command downloads the specified file through the Ethernet port to the 
default boot address. 



Format 



netload [file [address]] 



Parameters 



file 

Specifies a legal file name to be downloaded to the motherboard. The default is to load 
the file specified in the bootptab file. 

address 

Specifies the address at which to download the file. The default is the boot address. 



Description 



Example 



The netload command uses BOOTP to download the specified file through the Ether- 
net port. The Ethernet port is selected using the edevice command. The program is 
loaded into the default boot address. You can set up or change the boot address with the 
bootadr command. The program can then be executed with the go or jtopal command. 

A default file and directory path may be defined in the bootptab file. See 
Section 2.3.4.2 for more information. 

If you specify an address, this address becomes the default boot address. This value, 
however, is not set in battery-backed RAM. 



In this example, a file called size is loaded into the default boot address. 



DP2 64> netload size 

Ethernet Base Address: 360, 
Init Block Address 80000 
Init Done. 

Ethernet BA-98-7 6-54-32-10 
Attempting BOOTP ... success . 

my IP address: 16.123. 
server IP address: 16.123. 
gateway IP address: 16.123. 
Loading from /users/eval/boot /size 
### 



DMA Mask: 



.45.67 
.45.69 
.45.69 



DRQ5 
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4.4.71 next — Execute Next Machine Instruction 



The next command executes the machine instruction without stepping into subrou- 
tines. 



Format 



Parameters 



n[ext] 



None. 



Description 



Example 



Use the step command and the next command to execute a machine instruction. When 
the instruction contains a subroutine, the step command steps into the subroutine being 
called and the next command executes the subroutine being called. 



In the following example, the step command used at address 200034 steps to the first 
instruction of the function being called at address 2000c0. The next command used at 
address 2000ec executes the function being called and steps to the next instruction at 
address 2000f0. 



DP264> dis 
00200030: a77cl8010 
00200034: 6b5b4000 
00200038: 27ba0001 
0020003c: 23bdcl48 
DP2 64> step 
00200030: a77cl8010 
DP2 64> step 
00200034: 6b5b4000 
DP2 64> step 
002000cO: 27bb0001 



Idq 


r27. 


32784 (r29) 


jsr 


r26. 


r27 


Idah 


r29. 


1 (r26) 


Ida 


r29. 


49480 (r29) 


Idq 


r27. 


32784 (r29) 


jsr 


r26. 


r27 


Idah 


r29. 


1 (r27) 



DP264> dis 
002000e8: a77d8040 
002000ec: 6b5b46b8 
002000fO: 27ba0001 
DP2 64> step 
002000e8: a77d8040 
DP2 64> step 
002000ec: 6b5b46b8 
DP2 64> next 
002000fO: 27ba0001 
DP264> 



Idq r27, 32832 (r29) 

jsr r26, r27 

Idah r29, l(r26) 

Idq r27, 32832 (r29) 

jsr r26, r27 

Idah r29, l(r26) 
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4.4.72 pb — Display Memory Byte 

The pb command displays the specified memory byte (8-bit). 

Format 

pb [start_address [end_address [iterations [silent]]]] 

Parameters 

start_address 

Specifies a hexadecimal number that represents a legal address at which to start the dis- 
play. The default is the current address. 

end_address 

Specifies a hexadecimal number that represents a legal address at which to end the dis- 
play. The default is the current address plus 127 bytes. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



Example 



The pb command displays the specified memory in byte format. If no address is speci- 
fied, then the current memory byte and the following 127 bytes are displayed. The field 
displayed after the bytes represents the translation of the memory contents in ASCII 
characters. If the memory contents can be translated to an ASCII character, then that 
character is displayed; otherwise, a dot is displayed. 

The silent and iterations fields are often used together to continuously perform read 
operations, thus, avoiding slowdowns caused by displaying the data. The repeating 
cycles can be monitored with test equipment. 



This example displays 128 bytes from memory starting with 100000 in byte format. 
DP264> pb 100000 



00100000: 
00100010: 
00100020: 
00100030: 
00100040: 
00100050: 
00100060: 
00100070: 



03 00 00 CI 00 00 00 00 10 D9 10 00 00 00 00 00 
07 00 88 2F 00 00 9E A4 05 14 CI 43 06 14 Al 40 
22 77 80 48 06 04 C2 40 FO 82 DC B4 F8 82 9C B4 
00 83 BC B4 3E 15 C5 43 20 00 FE B7 08 83 FC B3 
07 00 00 DO 04 04 E2 47 19 10 00 DO 80 00 00 00 
IF 04 FF 47 00 00 00 00 00 00 00 00 00 00 00 00 



3E 15 C6 43 28 00 IE B4 36 01 00 DO 18 



9C A4 



05 34 EO 43 09 03 00 DO 20 



9C A4 05 54 EO 43 





/ 




r 


(3 


^^w 


H 


(3 








.>. 


.c . 








r-, 








>. 

.4 


C(. 
C. 


..6. 




r.c 
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4.4.73 pcishow — Display PCI Slots and Mapping 



The pcishow command displays the contents of each PCI slot and the current 
PCI-to-system address space mapping. 



Format 



pcisliow bus id function 



Parameters 



bus 

Specifies which bus to show. The default value is 0. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

function 

Specifies which funtion to read from. The default value is 0. 



Description 



Example 



The pcishow command applies only to PCI motherboards. 



DP2 64> pcishow 

PCI Address Mapping windows are: 

(1) PCI Base = 0x00100000, Size = 0x00100000 
Translated Base = 0x00100000 



Bus 


= 




primary = 0, secondar 




PCI I/O space = 1000, 




PCI I/O base = BOOO, 


PCI 


slot 18, vendor = 0x1011, 




PCI 10 Base = 0x0, PC 




PCI Mem Base = 0x2000 




Display controller 


PCI 


slot 19, vendor = 0x8086, 




PCI 10 Base = 0x0, PC 




PCI Mem Base = 0x0, P' 




Non-VGA compatible de 


PCI 


slot 17, vendor = 0x1011, 




PCI 10 Base = OxBOOO, 




PCI Mem Base = 0x4000 




Ethernet controller 


PCI 


slot 20, vendor = 0x1000, 




PCI 10 Base = 0xB400, 




PCI Mem Base = 0x4001 




Non-VGA compatible de 


DP264> 



y = 0, subordinate = 
PCI Mem space = 3F00000 

PCI Mem base = 200000 
device = 0x4 

I 10 Size = 0x0 

000, PCI Mem Size = 0x2000000 

device = 0x484 
I 10 Size = 0x0 
CI Mem Size = 0x0 
vice 

device = 0x2 

PCI 10 Size = 0x80 
000, PCI Mem Size = 0x80 

device = 0x1 

PCI 10 Size = 0x100 
000, PCI Mem Size = 0x100 
vice 
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4.4.74 pfreg — Display Floating Point Register State 

The pfreg command displays the saved CPU floating-point register state. 

Format 

pfreg [address] 
Parameters 

address 



Specifies an alternate address for the saved-state area. 



Description 



The pfreg command displays the contents of the CPU floating-point registers stored in 
the saved-state area. A register state is stored when a breakpoint is encountered or the 
PALcode reset flow is entered. 



Example 



DP2 64> pfreg 

Floating Point Reg 
register file @ : 
fOO: 0000000000000000 
f04: 0000000000000000 
f08: 0000000000000000 
fl2: 0000000000000000 
fl6: 0000000000000000 
f20: 0000000000000000 
f24: 0000000000000000 
f28: 0000000000000000 
PC: OOOOOOOOOOOOOOOD 



isters 

000C840 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 



0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 



0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 



PS: OOOOOOOOOOOOOOOD 
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4.4.75 pi — Display Memory Longword 

The pi command displays the specified memory longword (32-bit). 

Format 

pi [start_address [end_address [iterations [silent]]]] 

Parameters 

start_address 

Specifies a hexadecimal number that represents a legal address at which to start the dis- 
play. The default is the current address. 

end_address 

Specifies a hexadecimal number that represents a legal address at which to end the dis- 
play. The default is the current address plus 127 bytes. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



Example 



The pi command displays the specified memory in longword format. If no address is 
specified, then the current memory longword and the following 3 1 longwords are dis- 
played. The field displayed after the longword represents the translation of the memory 
contents in ASCII characters. If the memory contents can be translated to an ASCII 
character, then that character is displayed; otherwise, a dot is displayed. 

The silent and iterations fields are often used together to continuously perform read 
operations, thus, avoiding slowdowns caused by displaying the data. The repeating 
cycles can be monitored with test equipment. 



This example displays memory longwords. 

DP264> pi 

00000000: E7E01021 00000000 00000000 00000000 ! 

00000010: 00000000 00000000 00000000 00000000 

00000020: E7E01095 00000000 00000000 00000000 

00000030: 00000000 00000000 00000000 00000000 

00000040: 00000000 00000000 00000000 00000000 

00000050: 00000000 00000000 00000000 00000000 

00000060: 00000000 00000000 00000000 00000000 

00000070: 00000000 00000000 00000000 00000000 

DP264> pi 

00000090: 00000000 00000000 00000000 00000000 

OOOOOOAO: 00000000 00000000 00000000 00000000 

OOOOOOBO: 00000000 00000000 00000000 00000000 

OOOOOOCO: 00000000 00000000 00000000 00000000 

OOOOOODO: 00000000 00000000 00000000 00000000 

OOOOOOEO: 74420082 644200A9 74210081 64210024 . .Bt . .Bd. . ! t$ . !d 

OOOOOOFO: 48405682 F0400013 E4400003 77DE009E .V@H..@...@ w 

00000100: 67DE009F 44205401 47E09402 744200A9 ...g.T D...G..Bt 
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DP264> pi 100000 

00100000: C1000003 00000000 0010D910 00000000 

00100010: 2F880007 A49E0000 43C11405 40A11406 .../ C...@ 

00100020: 48807722 40C20406 B4DC82F0 B49C82F8 "w.H...@ 

00100030: B4BC8300 43C5153E B7FE0020 B3FC8308 >..C 

00100040: D0000007 47E20404 D0001019 00000080 G 

00100050: 47FF041F 00000000 00000000 00000000 . . .G 

00100060: 43C6153E B41E0028 D0000136 A49C8018 >..C{...6 

00100070: 43E03405 D0000309 A49C8020 43E05405 .4.C T.C 

DP264> pi 100000 100000 

00100000: C1000003 00000000 0010D910 00000000 
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4.4.76 pq — Display Memory Quadword 



The pq command displays the specified memory quadword (64-bit). 



Format 



pq [start_address [end_address [iterations [silent]]]] 



Parameters 



start_address 

Specifies a hexadecimal number that represents a legal address at which to start the dis- 
play. The default is the current address. 

end_address 

Specifies a hexadecimal number that represents a legal address at which to end the dis- 
play. The default is the current address plus 127 bytes. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



Example 



The pq command displays the specified memory in quadword format. If no address is 
specified, then the current memory quadword and the following 15 quadwords are dis- 
played. The field displayed after the quadword represents the translation of the memory 
contents in ASCII characters. If the memory contents can be translated to an ASCII 
character, then that character is displayed; otherwise, a dot is displayed. 

The silent and iterations fields are often used together to continuously perform read 
operations, thus, avoiding slowdowns caused by displaying the data. The repeating 
cycles can be monitored with test equipment. 

This example displays memory quadwords. 



DP264> pq 

00000000 

00000010 

00000020 

00000030 

00000040 

00000050 

00000060 

00000070 

DP264> pq 

00100000 

00100010 

00100020 

00100030 

00100040 

00100050 

00100060 

00100070 



00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
10000 
00000 
A49E0 
40C20 
43C51 
47E20 
00000 
B41E0 
DOOOO 



000E7E01021 

00000000000 

000E7E01095 

00000000000 

00000000000 

00000000000 

00000000000 

00000000000 



000C1000003 

0002F880007 

40648807722 

53EB4BC8300 

404D0000007 

00047FF041F 

02843C6153E 

30943E03405 



0000000000000000 ! 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

0000000000000000 

000000000010D910 
40A1140643C11405 
B49C82F8B4DC82F0 
B3FC8308B7FE0020 
00000080D0001019 
0000000000000000 
A49C8018D0000136 > 
43E05405A49C8020 . 



T.C 
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4.4.77 prb — Read Byte from PCI Configuration Space 

The prb command reads a byte (8 bits) from the specified address in the PCI configura- 
tion space. 

Format 

prb pci_address id bus function 
Parameters 

pci_address 

Specifies the address in PCI space. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

bus 

Specifies which bus to read from. The default value is 0. 

function 

Specifies which function to read from. The default value is 0. 

Description 

The prb command reads a byte from the specified address in the PCI configuration 
space for a device specified by the id. If the motherboard does not support PCI, then 
this command is not implemented. If your system configuration supports multiple PCI 
buses, use the parameters to specify the PCI device. Use the pcishow command to view 
the available PCI devices. 



Example 



DP264> prb 19 
86 
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4.4.78 preg — Display General-Purpose Registers 



Format 
Parameters 

Description 



The preg command displays the saved CPU general-purpose register state. 
preg [address] 

address 

Specifies an alternate address for the saved-state area. 



The preg command displays the contents of the CPU general-purpose registers stored 
in the saved-state area. A register state is stored when a breakpoint is encountered or the 
PALcode reset flow is entered. 



Example 



DP2 64> preg 

General Purpose Re 
register file @ : 



rOO 
r04 
r08 
rl2 
rl6 
r20 
r24 
r28 
PC: 



0000000000000020 
00000000000003F8 
FFFFFC000005F470 
208090EA6024C19C 
0000000000100000 
0000000E20026335 
0000000000000003 
FFFFFC02C0000000 
OOOOOOOOOOOOOOOD 



gisters 
000C040 

0000000000000005 OOOOOOOOOOOOCOOO 
0000000000000000 0000000000000000 
0000000000027340 0444306453605341 
882C08AA92065B2D 4100610AE100244F 
OOOOOOOOOOOOOOOD 0000000000000006 
5619A46B2B1A5125 0000000000000000 
0000000000000000 FFFFFC0000042C3C 
FFFFFC000006C1E0 0000000000FFDF40 
PS: OOOOOOOOOOOOOOOD 



OOOOOOOOOOOOOOOD 
OOOOOOOOOOOOOOOD 
0A110C485F6Efl26E 
9E2891ACA8A9D984 
0000000000000030 
OOOOOOOOOOOOOOOD 
0000000000100000 
0000000000000003 
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4.4.79 pri — Read Longword from PCI Configuration Space 

The prI command reads a longword (32 bits) from the specified address in the PCI con- 
figuration space. 

Format 

prI pci_address id bus function 
Parameters 

pci_address 

Specifies the address in PCI space. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

bus 

Specifies which bus to read from. The default value is 0. 

function 

Specifies which function to read from. The default value is 0. 

Description 

The prl command reads a longword from the specified address in the PCI configuration 
space for a device specified by the id. If the motherboard does not support PCI, then 
this command is not implemented. If your system configuration supports multiple PCI 
buses, use the parameters to specify the PCI device. Use the pcishow command to view 
the available PCI devices. 



Example 



DP264> prl 19 
04848086 
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4.4.80 prw — Read Word from PCI Configuration Space 



The prw command reads a word (16 bits) from the specified address in the PCI config- 
uration space. 



Format 



prw pci_address id bus function 



Parameters 



pci_address 

Specifies the address in PCI space. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

bus 

Specifies which bus to read from. The default value is 0. 

function 

Specifies which function to read from. The default value is 0. 



Description 



Example 



The prw command reads a word from the specified address in the PCI configuration 
space for a device specified by the id. If the motherboard does not support PCI, then 
this command is not implemented. If your system configuration supports multiple PCI 
buses, use the parameters to specify the PCI device. Use the pcishow command to view 
the available PCI devices. 



DP2 64> pcishow 



PCI 


Address Mapping windo 




(1) PCI Base = Ox 




Translate 


Bus 


= 




primary = 0, seco 




PCI I/O space = 1 




PCI I/O base = BO 


PCI 


slot 17, vendor = 0x1 




PCI 10 Base = 0x0 




PCI Mem Base = Ox 




PCI-PCI bridge 


PCI 


slot 19, vendor = 0x8 




PCI 10 Base = 0x0 




PCI Mem Base = Ox 




Non-VGA compatibl 


Bus 


= 1 




primary = 0, seco 




PCI I/O space = 1 




PCI I/O base = BO 


PCI 


slot 6, vendor = 0x10 




PCI 10 Base = OxB 




PCI Mem Base = Ox 




Ethernet controll 



ws are : 

00100000, Size = 0x00100000 

d Base = 0x00100000 

ndary = 0, subordinate = 1 
000, PCI Mem space = 100000 
00, PCI Mem base = 200000 
Oil, device = 0x1 
, PCI 10 Size = 0x0 
0, PCI Mem Size = 0x0 

086, device = 0x484 
, PCI 10 Size = 0x0 
0, PCI Mem Size = 0x0 
e device 

ndary = 1, subordinate = 1 

000, PCI Mem space = 100000 

00, PCI Mem base = 200000 

11, device = 0x2 

000, PCI 10 Size = 0x80 

200000, PCI Mem Size = 0x80 

er 
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DP2 64> prw 6 1 

1011 

DP264> prw 19 

8086 
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4.4.81 pw — Display Memory Word 



The pw command displays the specified memory word (16-bit). 



Format 



pw [start_address [end_address [iterations [silent]]]] 



Parameters 



start_address 

Specifies a hexadecimal number that represents a legal address at which to start the dis- 
play. The default is the current address. 

end_address 

Specifies a hexadecimal number that represents a legal address at which to end the dis- 
play. The default is the current address plus 127 bytes. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 



Description 



Example 



The pw command displays the specified memory in word format. If no address is spec- 
ified, then the current memory word and the following 63 words are displayed. The 
field displayed after the word represents the translation of the memory contents in 
ASCII characters. If the memory contents can be translated to an ASCII character, then 
that character is displayed; otherwise, a dot is displayed. 

The silent and iterations fields are often used together to continuously perform read 
operations, thus, avoiding slowdowns caused by displaying the data. The repeating 
cycles can be monitored with test equipment. 



0003 ClOO 0000 0000 D910 0010 0000 0000 

0007 2F88 0000 A49E 1405 43C1 1406 40A1 .../. 



This example displays eight memory addresses starting with lOOOOOj^ in word format. 

DP264> pw 100000 

00100000 

00100010 

00100020 

00100030 

00100040 

00100050 

00100060 

00100070 



7722 4880 0406 40C2 82F0 B4DC 82F8 B49C "w.H. 
8300 B4BC 153E 43C5 0020 B7FE 8308 B3FC ....> 
0007 DOOO 0404 47E2 1019 DOOO 0080 0000 



041F 47FF 0000 0000 0000 0000 0000 0000 ...G. 
153E 43C6 0028 B41E 0136 DOOO 8018 A49C >..C( 
3405 43E0 0309 DOOO 8020 A49C 5405 43E0 .4.C. 



.6 



T.C 
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4.4.82 pwb — Write Byte to PCI Configuration Space 

The pwb command writes a byte (8 bits) to an address in the PCI configuration space. 

Format 

pwb pci_address id data bus function 
Parameters 

pci_address 

Specifies which address to write to. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

data 

Specifies the value that is written to the pci_address. 

bus 

Specifies which bus to write to. The default value is 0. 

function 

Specifies which function to write from. The default value is 0. 

Description 

The pwb command writes a byte to the specified address in the PCI configuration space 
for a device specified by the id. If the motherboard does not support PCI, then this com- 
mand is not implemented. If your system configuration supports multiple PCI buses, 
use the parameters to specify the PCI device. Use the pcishow command to view the 
available PCI devices. 



Example 



DP264> prb 4f 19 

3F 

DP264> pwb 4f 19 2f 

DP264> prb 4f 19 

2F 
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4.4.83 pwl — Write Longword to PCI Configuration Space 

The pwl command writes a longword (32 bits) to an address in the PCI configuration 
space. 

Format 

pwl pci_address id data bus function 
Parameters 

pci_address 

Specifies which address to write to. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

data 

Specifies the value that is written to the pci_address. 

bus 

Specifies which bus to write to. The default value is 0. 

function 

Specifies which function to write from. The default value is 0. 

Description 

The pwl command writes a longword to the specified address in the PCI configuration 
space for a device specified by the id. If the motherboard does not support PCI, then 
this command is not implemented. If your system configuration supports multiple PCI 
buses, use the parameters to specify the PCI device. Use the pcishow command to view 
the available PCI devices. 



Example 



DP264> pwl 4f 19 OOOOaSfS 
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4.4.84 pww — Write Word to PCI Configuration Space 

The pww command writes a word (16 bits) to an address in tiie PCI configuration 
space. 

Format 

pww pci_address id data bus function 
Parameters 

pci_address 

Specifies which address to write to. 

id 

Specifies a decimal number that represents the slot assigned to the PCI device. 

data 

Specifies the value that is written to the pci_address. 

bus 

Specifies which bus to write to. The default value is 0. 

function 

Specifies which function to write from. The default value is 0. 

Description 

The pww command writes a word to the specified address in the PCI configuration 
space for a device specified by the id. If the motherboard does not support PCI, then 
this command is not implemented. If your system configuration supports multiple PCI 
buses, use the parameters to specify the PCI device. Use the pcishow command to view 
the available PCI devices. 



Example 



DP264> pww 4f 19 4 
DP264> prw 4f 19 
0004 
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4.4.85 rb — Read Byte from I/O Address Space 

The rb command reads a byte (8 bits) from a register port in I/O address space. 

Format 

rb register [iterations [silent]] 
Parameters 

register 

Specifies the register from the I/O address space. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 

Description 

The rb command reads a byte from the specified register in I/O address space. 
Example 

DP264> rb 370 

04 
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4.4.86 rl — Read Longword from I/O Address Space 

The rl command reads a longword (32 bits) from a register port in I/O address space. 

Format 

rl register [iterations [silent]] 
Parameters 

register 

Specifies the register from the I/O address space. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 

Description 

The rl command reads a longword from the specified register in I/O address space. 

Example 

DP264> rl 370 
0000A6F3 



4-102 User Commands 8April1999 



User Commands 



4.4.87 rmode — Set dis Command Register Display Mode 

The rmode command sets the dis command register display mode. 

Format 

rmode [mode] 
Parameters 

mode 



Determines the mode. If set (1), the software register names are displayed. If cleared 
(0), the hardware register names are displayed. The default is 0. 



Description 



The rmode command specifies whether hardware register names, such as r 16, or soft- 
ware register names, such as aO, are displayed with the dis command. 

The following table displays the Tru64 UNIX Alpha microprocessor register usage. 



Hardware 

Register 

Name 


Software 
Register 
Name 


Use and Linl<age 


rO 


vO 


Used for expression evaluation and to hold integer 
function results. 


rl...r8 


t0...t7 


Temporary registers; not preserved across procedure 
calls. 


r9...rl4 


s0...s5 


Saved registers; their values must be preserved 
across procedure calls. 


rl5 


FP or s6 


Frame pointer or a saved register. 


rl6...r21 


a0...a5 


Argument registers; used to pass the first six integer 
type arguments; their values are not preserved across 
procedure calls. 


r22...r25 


t8...tll 


Temporary registers; not preserved across procedure 
calls. 


r26 


ra 


Contains the return address; used for expression 
evaluation. 


r27 


pv ortl2 


Procedure value or a temporary register. 


r28 


at 


Assembler temporary register; not preserved across 
procedure calls. 


r29 


GP 


Global pointer. 


r30 


SP 


Stack pointer. 


r31 


zero 


Always has the value 0. 



If you enter the command without a parameter, then the current mode is displayed. The 
rmode setting is stored in battery -backed RAM. 
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Example 



DP2 64> rmode 


rmode = 




DP264> dis 


243a0 


000243A0: 


43020122 


000243A4: 


48441722 


000243A8: 


74420050 


00243AC: 


64630082 


000243B0: 


209F07E1 


000243B4: 


48855724 


000243B8: 


44640103 


000243BC: 


47203019 


DP264> dis 




000243C0: 


4B037698 


000243C4: 


4703F118 


000243C8: 


47190418 


000243CC: 


4B055738 


000243D0: 


44780403 


000243D4: 


746300A2 


000243D8: 


77FF0055 


000243DC: 


77FF0000 


DP2 64> rmode 1 


DP264> dis 


243a0 


000243A0: 


43020122 


00243A4: 


48441722 


000243A8: 


74420050 


000243AC: 


64630082 


000243B0: 


209F07E1 


000243B4: 


48855724 


000243B8: 


44640103 


000243BC: 


47203019 


DP264> dis 




000243C0: 


4B037698 


000243C4: 


4703F118 


000243C8: 


47190418 


000243CC: 


4B055738 


000243D0: 


44780403 


000243D4: 


746300A2 


000243D8: 


77FF0055 


000243DC: 


77FF0000 


DP264> 





subl 


r24 


r2, r2 


sll 


r2. 


0x20, r2 


mt 


r2. 


CO 


mf 


r3. 


pt2 


Ida 


r4. 


2017 (zero) 


sll 


r4. 


Ox2A, r4 


bic 


r3. 


r4, r3 


and 


r25 


0x1, r25 


srl 


r24 


OxlB, r24 


bic 


r24 


OxlF, r24 


bis 


r24 


r25, r24 


sll 


r24 


0x2A, r24 


bis 


r3. 


r24, r3 


mt 


r3. 


A2 


mt 


zero, flushlc 


mt 


zero, 


subl 


tio 


tl, tl 


sll 


tl. 


0x20, tl 


mt 


tl. 


CO 


mf 


t2. 


pt2 


Ida 


t3. 


2017 (zero) 


sll 


t3. 


Ox2A, t3 


bic 


t2. 


t3, t2 


and 


til 


0x1, til 


srl 


tio 


OxlB, tlO 


bic 


tio 


OxlF, tlO 


bis 


tio 


til, tio 


sll 


tio 


0x2A, tlO 


bis 


t2. 


tlO, t2 


mt 


t2. 


A2 


mt 


zero, flushlc 


mt 


zero, 
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4.4.88 romboot — Load and Execute Image from ROM 

The romboot command loads the specified image from ROM and begins execution. 



Format 



Parameters 



romboot [type] [address] 



type 

Specifies the image to load into ROM. If the type is specified as #0, then any header 
information is ignored and the entire contents of the ROM is loaded. The default is to 
load and execute the first image in the system ROM. 

address 

Specifies the starting address for loading the image into ROM. 



Description 



Example 



The romboot command loads and executes the operating system and associated firm- 
ware from the system ROM. Use the romlist command to display the images contained 
in the ROM. You can specify the type as a number or a name. 



Type_number 


Type_name 


Description 





DBM 


Alpha Motherboard Debug Monitor 


1 


NT 


Windows NT 


2 


VMS 


OpenVMS 


3 


UNIX 


Tru64 UNIX 


7 


LINUX 


Linux, MILO 


8 


VXWORKS 


VxWorks 


10 


SROM 


Serial ROM 



The romboot command can also be used to select a ROM image based on its position 
in the ROM. Specifying the type as #0 selects the entire ROM. Specifying the type as 
#1 selects the first image; #2 selects the second image, and so on. 

You can specify an address to override what is in the image file header. You may also 
use the bootadr command. Use the system reset to reset the motherboard to the initial 
booted state. 



DP2 64> romboot 

Searching for ROM image #1 

Header Size 52 bytes 

Image Checksum 0x581A (22554) 

Image Size (Uncomp) . 117160 (114 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID - Alpha Evaluation Board Debug Monitor 

ROM Image Size 117160 (114 KB) 

Firmware ID (Opt.).. 0000000000000000 ASCII: 

Header Checksum 0x8F5C 
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Loading ROM to address 00300000 

Image checksum verified. 0x581A 

Loaded 117160 bytes starting at 300000 to 31C9A8 

Jumping to 0x300000... 

DP2 64> romboot #2 

Searching for ROM image #2 

Header Size 52 bytes 

Image Checksum 0xD38C (54156) 

Image Size (Uncomp) . 211728 (206 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID 1 - Windows NT Firmware 

ROM Image Size 211728 (206 KB) 

Firmware ID (Opt.).. 0305109502131030 ASCII: 0. 

Header Checksum OxCED2 

Loading ROM to address 00300000 

Image checksum verified. 0xD38C 

Loaded 211728 bytes starting at 300000 to 333B10 

Jumping to 0x300000... 

DP2 64> romboot unix 

Searching for the "Alpha SRM Console". 

The specified ROM image was not found 

DP2 64> romboot nt 

Searching for the "Windows NT Firmware". 

Header Size 52 bytes 

Image Checksum 0xD38C (54156) 

Image Size (Uncomp) . 211728 (206 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID 1 - Windows NT Firmware 

ROM Image Size 211728 (206 KB) 

Firmware ID (Opt.).. 0305109502131030 ASCII: 0. 

Header Checksum 0xCED2 

Loading ROM to address 00300000 

Image checksum verified. 0xD38C 

Loaded 211728 bytes starting at 300000 to 333B10 

Jumping to 0x300000... 
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4.4.89 romlist — List ROM Image Headers 

The romlist command lists the ROM image headers contained in ROM. 

Format 

romlist 
Parameters 

None. 

Description 



Example 



The romlist command searches the system ROM for any ROM image headers that 
might be present. It then prints a summary for each header found. 



DP2 64> romlist 

ROM image header found at offset: 0x000000 

Header Size 52 bytes 

Image Checksum 0x8111 

Image Size (Uncomp) . 129552 (126 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID - Alpha Evaluation Board Debug Monitor 

ROM Image Size 129552 (126 KB) 

Firmware ID (Opt.).. 0000000000000000 ASCII: 

Header Checksum 0xA839 

ROM image header found at offset: 0x040000 

Header Size 52 bytes 

Image Checksum 0xD38C 

Image Size (Uncomp) . 211728 (206 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID 1 - Windows NT Firmware 

ROM Image Size 211728 (206 KB) 

Firmware ID (Opt.).. 0305109502131030 ASCII: 

Header Checksum 0xCED25 

DP264> 
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4.4.90 romload — Load OS and Firmware from ROM 

The romload command loads the specified image from ROM to the specified address. 



Format 



Parameters 



romload [type] [address] 



type 

Specifies the image to load into ROM. If the type is specified as #0, then any header 
information is ignored and the entire contents of the ROM is loaded. The default is to 
load the first image in the system ROM. 

address 

Specifies the starting address for loading the image into ROM. 



Description 



The romload command loads the operating system and associated firmware from the 
system ROM. Use the romlist command to display the images contained in the ROM. 
You can specify the type as a number or a name. 



Example 



Type_number 


Type_name 


Description 





DBM 


Alpha Motherboard Debug Monitor 


1 


NT 


Windows NT 


2 


VMS 


OpenVMS 


3 


UNIX 


Tru64 UNIX 


7 


LINUX 


Linux, MILO 


8 


VXWORKS 


VxWorks 


10 


SROM 


Serial ROM 



The romload command can also be used to select a ROM image based on its position in 
the ROM. Specifying the type as #0 selects the entire ROM. Specifying the type as #1 
selects the first image; #2 selects the second image, and so on. 

You can specify an address to override what is in the image file header. You may also 
use the bootadr command. Use the jtopal command to execute the image. 



DP2 64> romload #0 

Loading entire ROM. 

Loading ROM to address 00200000 

Loaded 1048576 bytes from 200000 to 300000 

DP264> 

DP2 64> romload #1 

Searching for ROM image #1 

Header Size 52 bytes 

Image Checksum 0x581A (22554) 

Image Size (Uncomp) . 117160 (114 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID - Alpha Evaluation Board Debug Monitor 
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ROM Image Size 117160 (114 KB) 

Firmware ID (Opt.).. 0000000000000000 ASCII: 

Header Checksum 0x8F5C 

Loading ROM to address 00300000 

Image checksum verified. 0x581A 

Loaded 117160 bytes from 300000 to 31C9A8 

DP264> 

DP2 64> romload 

Searching for ROM image #1 

Header Size 52 bytes 

Image Checksum 0x581A (22554) 

Image Size (Uncomp) . 117160 (114 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID - Alpha Evaluation Board Debug Monitor 

ROM Image Size 117160 (114 KB) 

Firmware ID (Opt.).. 0000000000000000 ASCII: 

Header Checksum 0x8F5C 

Loading ROM to address 00300000 

Image checksum verified. 0x581A 

Loaded 117160 bytes from 300000 to 31C9A8 

DP264> 

DP2 64> romload unix 

Searching for "Alpha SRM Console". 

The specified ROM image was not found 

DP264> 

DP2 64> romload nt 

Searching for "Windows NT Firmware". 

Header Size 52 bytes 

Image Checksum 0xD38C (54156) 

Image Size (Uncomp) . 211728 (206 KB) 

Compression Type. ... 

Image Destination... 0x0000000000300000 

Header Version 1 

Firmware ID 1 - Windows NT Firmware 

ROM Image Size 211728 (206 KB) 

Firmware ID (Opt.).. 0305109502131030 ASCII: 

Header Checksum OxCED2 

Loading ROM to address 00300000 

Image checksum verified. 0xD38C 

Loaded 211728 bytes from 300000 to 333B10 

DP264> 



8April1999 User Commands 4-109 



User Commands 

4.4.91 romverify — Compare Memory Image to ROM Image 

The romverify command compares an image in memory to an image in tiie ROM. 

Format 

romverify [type [address]] 
Parameters 

type 

Specifies the name or number of an image in the ROM to compare against memory. If 
the type specified is #0, then any header information is ignored and the entire contents 
of the ROM are compared. If the type is #n, the nth image in the ROM will be used (#2 
is the second entry). The default is to compare the first image in the system ROM. 

address 

Specifies the starting address for comparing the image in the ROM. The bootadr is the 
default. 



Description 



The romverify command compares an image in memory to an image in the ROM. Use 
the romlist command to display the images contained in the ROM. You can specify the 
type as a number or a name. 



Examples 



Type_number 


Type_name 


Description 





DBM 


Alpha Motherboard Debug Monitor 


1 


NT 


Windows NT 


2 


VMS 


OpenVMS 


3 


UNIX 


Tru64 UNIX 


7 


LINUX 


Linux, MILO 


8 


VXWORKS 


VxWorks 


10 


SROM 


Serial ROM 



DP2 64> romload #0 300000 

Loading entire ROM. 

Loading ROM to address 00300000 

Loaded 1048576 bytes starting at 0x300000 to 0x3fffff 

DP2 64> romverify #0 

Comparing entire ROM to image at 0x300000. 

Images match. 

DP2 64> netload PC164dbm. rom 

Attempting BOOT? . . . 

Loading PC164dbm.rom at 0x300000 

My IP address: 192.168.0.107 

Server IP address: 192.168.0.114 
################ 

File loaded successfully. Size = 0x28380 (164736) 
DP2 64> romverify dbm 

Searching for the "Alpha Evaluation Board Debug Monitor'' 
Comparing to image at 0x300000. 
Images match. 
DP2 64> romverify 300000 
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Searching for the "Alpha Evaluation Board Debug Monitor" . 

Comparing to image at 0x300000. 

Images match. 

DP2 64> romverify #1 300000 

Searching for ROM image #1 

Comparing to image at 0x300000. 

Images do not match. 

DP2 64> romverify #2 300000 

Searching for ROM image #2 

Comparing to image at 0x300000. 

Images match. 
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4.4.92 rw — Read a Word from I/O Address Space 

The rw command reads a word (16 bits) from a register port in I/O address space. 

Format 

rw register [iterations [silent]] 
Parameters 

register 

Specifies the register from the I/O address space. 

iterations 

Specifies how many times the data is read. The default is 1 . 

silent 

Specifies whether or not the data is displayed. Setting this field to 1 causes the data to 
be read but not displayed. The default is (data is displayed). 

Description 

The rw command reads a word from the specified register in I/O address space. 

Example 

DP264> rw 372 

0000 

DP264> rw 370 

A6B3 
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4.4.93 sb — Search Memory by Bytes 

The sb command searches memory by bytes (8 -bit). 

Format 

sb start_address end_address string [inverse] 
Parameters 

start_address 

Specifies the address at which to begin the search. 

end_address 

Specifies the address at which to end the search. 

String 

Specifies the search string. 

inverse 



Specifies whether to search for a matching string (0) or a nonmatching string (1). The 
default is (search for a matching string). 



Description 



Example 



The sb command searches memory by byte chunks for the specified string. You can use 
an asterisk (*) as a wildcard character for single-character matching. 



DP264> pi 100000 100080 

00100000: C3E00007 00000000 00000000 00000000 

00100010: 00000000 00000000 00000000 00000000 

00100020: 221F0000 26100012 6BF00000 00000000 ..."...&.. .k. 

00100030: 00000000 00000000 00000000 00000000 

00100040: 00000000 00000000 00000000 00000000 

00100050: 00000000 00000000 00000000 00000000 

00100060: 00000000 00000000 00000000 00000000 

00100070: 00000000 00000000 00000000 00000000 

00100080: 00000000 00000000 00000000 00000000 

DP264> sb 100000 100080 2* 
val = 20 mask = FO 
occurrence at 00100023 22 
occurrence at 00100027 25 
DP264> sb 100000 100080 1* 
val = 10 mask = FO 
occurrence at 00100022 IF 
occurrence at 00100024 12 
occurrence at 00100026 10 
DP264> sb 100000 100080 If 
val = IF mask = FF 
occurrence at 00100022 IF 
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4.4.94 setbaud — Set Port's Baud Rate 

The setbaud command sets the baud rate for the specified communication port con- 
nection. 



Format 



Parameters 



setbaud port baud_rate 



port 



Specifies the number identifier for the keyboard or serial port. 

baud_rate 

Specifies the baud rate for the specified port. The default is 9600. 



Description 



Example 



The setbaud command sets the baud rate for the specified keyboard or serial communi- 
cation port. The baud rate can be set to 1200, 2400, 9600, 19200, or 38400. 

The following table shows the port identifier numbers. 



Port ID 


Port Name 





Keyboard port 


1 


Serial communication port 1 


2 


Serial communication port 2 



DP2 64> setbaud 1 2400 
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4.4.95 setty — Specify Port for Debug Monitor 

The setty command sets the Debug Monitor to the specified port. 

Format 

setty port 
Parameters 

port 

Specifies the number identifier for the keyboard or serial port. 

Description 

The setty command specifies the port used for Debug Monitor interaction. The follow- 
ing table shows the port identifier numbers. 



Example 



Port ID 


Port Name 





Keyboard port 


1 


Serial communication port 1 


2 


Serial communication port 2 



DP2 64> setty 1 
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4.4.96 si — Search Memory by Longwords 

The sl command searches memory by longwords (32-bit). 

Format 

sl start_address end_address string [inverse] 
Parameters 

start_address 

Specifies the address at which to begin the search. 

end_address 

Specifies the address at which to end the search. 

String 

Specifies the search string. 

inverse 



Specifies whether to search for a matching string (0) or a nonmatching string (1). The 
default is (search for a matching string). 



Description 



Example 



The sl command searches memory by longword chunks for the specified string. You 
can use an asterisk (*) as a wildcard character for single-character matching. 



DP264 
00100 
00100 
00100 
00100 
00100 
00100 
00100 
00100 
DP264 
val = 
occur 
occur 
DP264 
val = 
occur 
occur 



> pi 1 

000 
010 
020 
030 
040 
050 
060 
070 

> sl 
20000 

rence 
rence 

> sl 1 
20100 

rence 
rence 



00000 

3E00007 00000000 00000000 
0000000 00000000 00000000 
21F0000 26100012 6BF00000 
0000000 00000000 00000000 
0000000 00000000 00000000 
0000000 00000000 00000000 
0000000 00000000 00000000 
0000000 00000000 00000000 
00000 100070 2******* 
000 mask = FOOOOOOO 
at 00100020 221F0000 
at 00100024 26100012 
00000 100070 2*1***** 
000 mask = FOFOOOOO 
at 00100020 221F0000 
at 00100024 26100012 



00000000 

00000000 

00000000 ..."...&.. .k. 

00000000 

00000000 

00000000 

00000000 

00000000 
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4.4.97 sq — Search Memory by Quadwords 



Format 



Parameters 



The sq command searches memory by quadwords (64-bit). 
sq start_address end_address string [inverse] 

start_address 

Specifies the address at which to begin the search. 

end_address 

Specifies the address at which to end the search. 

String 

Specifies the search string. 

inverse 

Specifies whether to search for a matching string (0) or a nonmatching string (1). The 
default is (search for a matching string). 



Description 



Example 



The sq command searches memory by quadword chunks for the specified string. You 
can use an asterisk (*) as a wildcard character for single-character matching. 



DP264 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
DP264 
val = 
value 
DP264 
value 



> pq 

000 
010 
020 
030 
040 
050 
060 
070 



00000000C3E00007 0000000000000000 

0000000000000000 0000000000000000 

26100002221F0000 000000006BF00000 ..."...&.. .k . 

0000000000000000 0000000000000000 

0000000000000000 0000000000000000 

0000000000000000 0000000000000000 

0000000000000000 0000000000000000 

0000000000000000 0000000000000000 

> sq 100000 100080 2 
2 mask = FFFFFFFFFFFFFFFF 
not found 

> sq 100000 100080 26100002221F0000 
= 26100002221F0000 mask = FFFFFFFFFFFFFFFF 

occurrence at 00000020 26100002221F0000 
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4.4.98 step — Execute Next Instruction 

The Step command executes the next instruction. 

Format 

s[tep] 
Parameters 



None. 



Description 



Example 



Use the step command and the next command to execute a machine instruction. When 
the instruction contains a subroutine call, the step command steps into the subroutine 
being called and the next command executes that subroutine. 

In the following example, the step command used at address 00200034 steps to the first 
instruction of the subroutine being called at address 002000c0. The next command used 
at address 002000ec executes the subroutine being called and steps to the next instruc- 
tion at address 002000f0. 



DP264> dis 
00200030: aVVdSOlO 
00200034: 6b5b4000 
00200038: 27ba0001 
0020003c: 23bclcl48 
DP2 64> step 
00200030: a77cl8010 
DP2 64> step 
00200034: 6b5b4000 
DP2 64> step 
002000cO: 27bb0001 



Idq 


r27. 


32784 (r29) 


jsr 


r26. 


r27 


Idah 


r29. 


1 (r26) 


Ida 


r29. 


49480 (r29) 


Idq 


r27. 


32784 (r29) 


jsr 


r26. 


r27 


Idah 


r29. 


1 (r27) 



DP264> dis 
002000e8: a77d8040 
002000ec: 6b5b46b8 
002000fO: 27ba0001 
DP2 64> step 
002000e8: a77d8040 
DP2 64> step 
02000ec: 6b5b46b8 
DP2 64> next 
002000fO: 27ba0001 
DP264> 



Idq r27, 32832 (r29) 

jsr r26, r27 

Idah r29, l(r26) 

Idq r27, 32832 (r29) 

jsr r26, r27 

Idah r29, l(r26) 
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4.4.99 stop — Set Breakpoint 



The Stop command sets a breakpoint. 



Format 



stop address 



Parameters 



address 

Specifies the address at which the breakpoint is set. 



Description 



Example 



The stop command sets a breakpoint at the specified address. When a breakpoint is 
encountered, all current register values are stored in memory and can be viewed with 
the preg and pfreg commands. 



DP264> stop 100000 

DP264> go 

Executing at 0x100000... 
00100000: C1000003 br 

DP264> stop 100200 

DP264> go 

Executing at 0x100000... 
00100200: 4A671793 sra 

DP2 64> cont 

00100200: 4A671793 sra 

This simple program prints the size of 

various data types in bytes. 

1 

2 

4 



r8, 100010 



rl9, 0x38, rl9 



rl9, 0x38, rl9 



char 
short 
int 
long = 8 
float = 4 
double = 8 
Alpha 21264 Evaluation Board (DP264) Debug Monitor 
Version: Fri Apr 09 20:50:11 EDT 1999 
Bootadr: 0x100000, memSize: 0x2000000 
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4.4.100 sum — Compute Checksum in Range 



The sum command computes the checksum of the data in the specified range. 



Format 



sum start address end address 



Parameters 



start_address 

Specifies the address at which the checksum check begins. 
end_address 

Specifies the address at which the checksum check ends. 



Description 



Example 



The sum command prints the checksum of the data contained in the specified memory 
range. The algorithm used computes a 16-bit checksum and is compatible with the stan- 
dard BSD4.3 algorithm provided in most implementations of UNIX (sum), thus allow- 
ing easy comparisons of images in the motherboard's memory with those on the UNIX 
host. 



DP2 64> netload pc64dbm.rom 

Alpha 21340 (0) : Initializing 

Hardware address = BA-98-76-54-32-10 

Trying 10 Base T 

Switching to AUI 
MAC address: BA-98-76-54-32-10 
Attempting BOOTP . . . 

Loading /sae_share/boot/userl/pc64 /pc64dbm. rom at 0x300000 
My IP address: 16.123.45.67 
Server IP address: 16.123.45.69 
################### 

File loaded successfully. Size = 0x30B80 (199552) 
DP264> sum 300000 330B7F 
0xe5cc 58828 
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4.4.101 sw — Search Memory by Words 



Format 



Parameters 



The SW command searches memory by words (16-bit). 
SW start_address end_address string [inverse] 

start_address 

Specifies the address at which to begin the search. 

end_address 

Specifies the address at which to end the search. 

String 

Specifies the search string. 

inverse 

Specifies whether to search for a matching string (0) or a nonmatching string (1). The 
default is (search for a matching string). 



Description 



Example 



The SW command searches memory by word chunks for the specified string. You can 
use an asterisk (*) as a wildcard character for single-character matching. 



DP264> pi 100000 100080 

00100000: C3E00007 00000000 00000000 
00100010: 00000000 00000000 00000000 
00100020: 221F0000 26100012 6BF00000 
00100030: 00000000 00000000 00000000 
00100040: 00000000 00000000 00000000 
00100050: 00000000 00000000 00000000 
00100060: 00000000 00000000 00000000 
00100070: 00000000 00000000 00000000 
00100080: 00000000 00000000 00000000 
DP264> SW 100000 100080 2*1* 
val = 2010 mask = FOFO 
occurrence at 00100022 221F 
occurrence at 00100026 2610 



00000000 

00000000 

00000000 ..."...&.. .k. 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 
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4.4.102 swpipl — Set or Display IPL 



The swpipl command sets or displays the interrupt priority level (IPL) of the CPU. 



Format 



Parameters 



Example 



swpipl [ipl] 



ipl 

Specifies the IPL ranging from to 7 as defined for Tru64 UNIX by the Alpha Archi- 
tecture Reference Manual. 



Description 



The swpipl command reports the current IPL when no parameter is provided. When a 
value of to 7 is provided to the swpipl command, the current IPL is set to that value. 
This command uses the swpipl PALcode instruction for Tru64 UNIX defined by the 
Alpha Architecture Reference Manual. The CPU arbitrates interrupt requests based on 
the IPL. When the current IPL is lower than a pending interrupt request, the CPU will 
raise the IPL while it services that interrupt. At IPL 7, no interrupt requests are handled. 
To avoid interrupt complexities when debugging hardware, the Debug Monitor is 
designed for minimal use of interrupts. Therefore, at startup, the IPL is set to 7 and can 
be lowered on demand using the swpipl command. Other commands that affect the IPL 
are the mcheck and the ladebug commands. 

In the following example, the IPL is lowered from 6 to 4. 



DP2 64> swpipl 

Current Interrupt Priority Level: 6 
DP2 64> swpipl 4 
DP2 64> swpipl 

Current Interrupt Priority Level : 4 
DP264> 
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4.4.103 sysshow — Display ROM Parameters 

The sysshow command displays all SROM parameters. 

Format 

sysshow 
Parameters 



None. 



Description 



The sysshow command displays the system status passed from the SROM at initializa- 
tion or reset. Refer to your motherboard's user's manual for more information about the 
SROM parameters displayed. 



Example 



DP2 64> sysshow 






abox_ctl 


428 






bcrO 


64C0 


bcrl 


10064C0 


bcr2 





bcr3 





bmrO 


FOOOOO 


bmrl 


FOOOOO 


bmr2 





bmr3 





srom_rev 


1805 


proc_id 


4 


mem_size 


2000000 


CYCle_cnt 


1771 


signature 


DECBOOOl 


proc_mask. 


1 


sysctx 





valid 


1 
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4.4.104 tip — Connect to Serial Communication Port 

The tip command connects to the specified serial communication port. 

Format 

tip port 
Parameters 

port 

Specifies the serial port. 

Description 

The tip command is a subset of the Tru64 UNIX t ip command. It allows you to con- 
nect directly from the motherboard to the specified serial communication port. You can 
specify 1 for serial port 1, or specify 2 for serial port 2. 

Example 

In this example, the host system is connected to serial port 1 . 

DP264> tip 1 
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4.4.105 version — Display Debug Monitor Firmware Version 

The version command displays the current Debug Monitor firmware version information. 

Format 

version 
Parameters 

None. 

Description 

The version command displays the current Debug Monitor firmware version informa- 
tion. This information is also displayed in the banner when you power up the mother- 
board. 



Example 



DP2 64> version 

Wed Feb 10 19:52:24 EST 1999 
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4.4.106 vinit — Initialize Video Controller 

The vinit command initializes the video controller. 

Format 

vinit 
Parameters 

None. 

Description 

The vinit command initializes the video controller. 

Example 

DP2 64> vinit 
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4.4.107 wb — Write Byte to I/O Address Space 

The wb command writes a byte (8 bits) to a register port in I/O address space. 

Format 

wb register data [iterations] 
Parameters 

register 

Specifies which register to write to. 

data 

Specifies the value that is written to the register. 

iterations 

Specifies how many times the data is read. The default is 1 . 

Description 

The wb command writes a byte to the specified register in I/O address space. 

Example 

DP264> rb 280 

28 

DP264> wb 280 68 

DP264> rb 280 

68 
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4.4.108 wl — Write Longword to I/O Space 

The wl command writes a longword (32 bits) to a register port in I/O address space. 

Format 

wl register data [iterations] 
Parameters 

register 

Specifies which register to write to. 

data 

Specifies the value that is written to the register. 

iterations 

Specifies how many times the data is read. The default is 1 . 

Description 

The wl command writes a longword to the specified register in I/O address space. 

Example 

DP264> wl 370 0000a6f3 
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4.4.109 wrfen — Write Floating-Point Enable 

The wrfen command enables or disables floating point. 

Format 

wrfen value 
Parameters 

value 



Specifies a value of or 1 that is written into the processor's floating-point enable reg- 
ister. 



Description 



The wrfen (write floating-point enable) command writes bit zero of the value passed to 
the floating-point enable register in the CPU. The value of FEN is also updated to the 
PCB. 



Example 

DP2 64> wrfen 1 
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4.4.110 WW — Write Word to I/O Address Space 

The WW command writes a word (16 bits) to a register port in I/O address space. 

Format 

WW register data [iterations] 
Parameters 

register 

Specifies which register to write to. 

data 

Specifies the value that is written to the register. 

iterations 

Specifies how many times the data is read. The default is 1 . 

Description 

The WW command writes a word to the specified register in I/O address space. For 
example, on the DP264, the word is written to the ISA extension slot. 



Example 



DP264> WW 370 4 
DP264> rw 370 

0004 
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A 

Support 

A.1 Customer Support 

The Alpha OEM website provides the following information for customer support. 

URL Description 

littp://www.digital.com/alpliaoem Contains the following links: 

• Developers' Area: Development tools, code examples, 
driver developers' information, and technical white 
papers 

• lUlotherboard Products: Motherboard details and 
performance information 

• lUlicroprocessor Products: Microprocessor details and 
performance information 

• News: Press releases 

• Technical Information: Motherboard firmware and 
drivers, hardware compatibility lists, and product 
documentation library 

• Customer Support: Feedback form 

A.2 Alpha Documentation 

The following table lists some of the available Alpha documentation. You can down- 
load Alpha documentation from the Alpha OEM World Wide Web Internet site: 

http://www.digital.com/alphaoem 

Click on Technical Information. 
Then click on Documentation Library. 

Title Order Number 

Alpha Architecture Reference Manual' EY-W938E-DP 

Alpha Architecture Handbook EC-QD2KC-TE 

Alpha 21164 Microprocessor Hardware Reference Manual EC-QP99C-TE 

Alpha 2 1 1 64 Microprocessor Data Sheet EC-QP98C-TE 
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Title 



Order Number 



Alpha 21164PC Microprocessor Hardware Reference Manual 

AlphaPC 264DP Product Brief 

AlphaPC 264DP User's Manual 

AlphaPC 264DP Technical Reference Manual 

AlphaPC 164SX Motherboard Product Brief 

AlphaPC 164SX Motherboard Windows NT User's Manual 

AlphaPC 164SX Motherboard DIGITAL UNIX User's Manual 

AlphaPC 164SX Motherboard Technical Reference Manual 

AlphaPC 164LX Motherboard Product Brief 

AlphaPC 164LX Motherboard Windows NT User's Manual 

AlphaPC 164LX Motherboard Tru64 UNIX User's Manual 

AlphaPC 164LX Motherboard Technical Reference Manual 

Alpha Motherboards Software Developer's Kit Product Brief 

Alpha Motherboards Software Developer's Kit Read Me First 

Alpha Microprocessors Motherboard Software Design Tools User's 
Guide 

Alpha Microprocessors SROM Mini-Debugger User's Guide 



EC-R2W0A-TE 

EC-RBDOA-TE 

EC-RBOBA-TE 

EC-RBODA-TE 

EC-R57CA-TE 

EC-R57DB-TE 

EC-R8P7B-TE 

EC-R57EB-TE 

EC-R2RZA-TE 

EC-R2ZQF-TE 

EC-R2ZPC-TE 

EC-R46WC-TE 

EC-QXQKD-TE 

EC-QERSJ-TE 

EC-QHUWE-TE 

EC-QHUXD-TE 



Not available on website. To purchase the Alpha Architecture Reference Manual, contact your local 
sales office or call Butterworth-Heinemann (DIGITAL Press) at 1—800—366-2665. 
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